Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
User friendly
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Gentoo Chat
View previous topic :: View next topic  
Author Message
pietinger
Moderator
Moderator


Joined: 17 Oct 2006
Posts: 5242
Location: Bavaria

PostPosted: Fri Jan 26, 2024 3:13 pm    Post subject: User friendly Reply with quote

I love automation because I am totally lazy. But I also want to know what happens. That's why I always recommend that newcomers do something manually first so that they understand what they are doing. That's why I love Gentoo. I just had an idea for a new XKCD ... (*)


Not user-friendly and not comprehensible:

Boot with a GentooCD and chroot into your system. Find out how to do that.

Not user-friendly, but comprehensible:

Boot with a GentooCD and chroot into your system with the commands: ...

User-friendly and comprehensible:

Boot with a GentooCd and chroot into your system with one command: "arch-chroot /mnt/gentoo". This will do ...

Too User-friendly, but not comprehensible:

Press "I". This installs a Gentoo just like any other linux distribution. Find out how we configured it.



*) Please don't forget, I love Gentoo ... and also humor ... with a pinch of truth in it ...
_________________
https://wiki.gentoo.org/wiki/User:Pietinger
Back to top
View user's profile Send private message
krumpf
Apprentice
Apprentice


Joined: 15 Jul 2018
Posts: 191

PostPosted: Fri Jan 26, 2024 4:49 pm    Post subject: Reply with quote

I'll just leave that link here
How to fix any computer
Back to top
View user's profile Send private message
spica
Guru
Guru


Joined: 04 Jun 2021
Posts: 331

PostPosted: Fri Jan 26, 2024 5:16 pm    Post subject: Re: User friendly Reply with quote

I think, if a designated target audience is clearly defined at the beginning of the document, it creates a more approachable and reader-friendly tone.

Quote:
For skilled engineers adept at independent problem-solving, follow these instructions:

Boot with a GentooCD and chroot into your system. Find out how to do that.

If you're tech-savvy and detail-oriented, here's what you need:

Boot with a GentooCD and chroot into your system with the commands: ...

Need an Explanation? No problem:

Boot with a GentooCd and chroot into your system with one command: "arch-chroot /mnt/gentoo". This will do ...

For the I-do-not-need-a-backup Enthusiasts (Press Next-Next-Next...):

Press "I". This installs a Gentoo just like any other linux distribution. Find out how we configured it.
Back to top
View user's profile Send private message
pietinger
Moderator
Moderator


Joined: 17 Oct 2006
Posts: 5242
Location: Bavaria

PostPosted: Sat Jan 27, 2024 3:56 am    Post subject: Re: User friendly Reply with quote

spica wrote:
I think, if a designated target audience is clearly defined at the beginning of the document, it creates a more approachable and reader-friendly tone.

I deliberately did not address a target group ... for one simple reason: telling someone that what they did was well-intentioned (for beginners) but poorly done (for Gentoo pros) will only cause that person to block. It's better to say something diplomatically with a little humor where no one feels offended ... but they still think about it ... ;-)
_________________
https://wiki.gentoo.org/wiki/User:Pietinger
Back to top
View user's profile Send private message
pjp
Administrator
Administrator


Joined: 16 Apr 2002
Posts: 20522

PostPosted: Sat Jan 27, 2024 4:13 am    Post subject: Reply with quote

krumpf wrote:
I'll just leave that link here
How to fix any computer
Quote:
Revert back to using
Windows or a Mac.
Quietly weep.
Consider reverting to Windows.
Remember MS Telemetry™.
Curl into a ball, no longer able to weep.
_________________
Quis separabit? Quo animo?
Back to top
View user's profile Send private message
NeddySeagoon
Administrator
Administrator


Joined: 05 Jul 2003
Posts: 54642
Location: 56N 3W

PostPosted: Sat Jan 27, 2024 9:57 am    Post subject: Reply with quote

pietinger,

Humour is best avoided on the wiki. It's not international and may depend on the readers grasp of English too.
That varies wildly, even among people who consider themselves native speakers.

Its always good to know your target audience. If you don't or can't (e.g. the Wiki) all that's left is to open with with minimal requirements for equipment and knowledge.
Stated or not, every technical writer assumes both.
_________________
Regards,

NeddySeagoon

Computer users fall into two groups:-
those that do backups
those that have never had a hard drive fail.
Back to top
View user's profile Send private message
pietinger
Moderator
Moderator


Joined: 17 Oct 2006
Posts: 5242
Location: Bavaria

PostPosted: Sat Jan 27, 2024 2:38 pm    Post subject: Reply with quote

NeddySeagoon wrote:
Humour is best avoided on the wiki. [...]

Yes, of course ... our wiki is sacred to me !
_________________
https://wiki.gentoo.org/wiki/User:Pietinger
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Gentoo Chat All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum