View previous topic :: View next topic |
Author |
Message |
pietinger Moderator
Joined: 17 Oct 2006 Posts: 5041 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: 185
|
|
Back to top |
|
|
spica Guru
Joined: 04 Jun 2021 Posts: 329
|
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: 5041 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: 20476
|
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: 54575 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: 5041 Location: Bavaria
|
|
Back to top |
|
|
|