| View previous topic :: View next topic |
| Author |
Message |
pietinger
Moderator
Joined: 17 Oct 2006
Posts: 5121
Location: Bavaria
|
 Posted: Fri Jan 26, 2024 3:13 pm Post subject: User friendly |
 |
|
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 |
|
 |
krumpf
Apprentice
Joined: 15 Jul 2018
Posts: 190
|
|
| Back to top |
|
|
spica
Guru
Joined: 04 Jun 2021
Posts: 330
|
| Posted: Fri Jan 26, 2024 5:16 pm Post subject: Re: User friendly |
|
|
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 |
|
|
pietinger
Moderator
Joined: 17 Oct 2006
Posts: 5121
Location: Bavaria
|
| Posted: Sat Jan 27, 2024 3:56 am Post subject: Re: User friendly |
|
|
| 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 |
|
|
pjp
Administrator
Joined: 16 Apr 2002
Posts: 20485
|
| Posted: Sat Jan 27, 2024 4:13 am Post subject: |
|
|
| 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 |
|
|
NeddySeagoon
Administrator
Joined: 05 Jul 2003
Posts: 54578
Location: 56N 3W
|
| Posted: Sat Jan 27, 2024 9:57 am Post subject: |
|
|
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 |
|
|
pietinger
Moderator
Joined: 17 Oct 2006
Posts: 5121
Location: Bavaria
|
|
| Back to top |
|
|
|
Gentoo Chat
