[wiki] PAE page: formatting and flavor-agnosticism

[Cyber Penguin]

Hi all

The wording 'showed no signs of willingness to cooperate and improve the
page to reach a compromise that satisfied both parties' could probably be
used for both of us. I'm surprised to see how much effort is put into this.

Anyway, to clarity:

The page has been Lubuntu-focused from its birth two years ago, and with
this single case as an exception I have only received good response for
that.

However, I am not particularly in love with Lubuntu and I have no intention
of marketing only this distro (some others are mentioned in the text). It
was used as an example because it's light, user friendly and reasonably
polished / bug free. Other distros could be used in stead, say Mate.

I wonder if people realise how weak this hardware is and how few distros
satisfy the three criteria above.

If the beginner reads a text which is neutral towards the distro he will
probably default to Ubuntu, waste his time and get a bad first impression.

Whether the information is presented as one page or divided into subpages
is not the main issue to me. I do however maintain that the text must be a
practical guide and meet the beginner where he is at present, first of all
by speaking his language and working in his pace. 'What to do' should be
presented up front, 'how it worked' comes later. Opening with a theoretical
walk-through and giving the reader the solution as a treat at the last step
is not a good way of helping, we have lost him before he gets to push the
first key on the keyboard.


Cheers
Mörgæs



On Sun, Mar 29, 2015 at 4:37 PM, Alberto Salvia Novella <
es20490446e at gmail.com> wrote:

> Pasi Lallinaho:
>
>> What do you think?
>>
>
> [image: 🐥] DIVIDE, AND CONQUER
>
> I had this discussion myself with other people. In my opinion the more
> atomized the information is, the easier and most understandable it is.
>
> I am completely against writing wikis as they where pages of a book.
> Because precisely the great power of a wiki is to show exactly as much
> information as you need, and nothing else.
>
> As example, I am rewriting the bug triage manual. And you can see it is
> now much easier than having a long manual:
>   - Before: https://wiki.ubuntu.com/Bugs/Triage
>   - After: https://wiki.ubuntu.com/One%20Hundred%20Papercuts/Work-
> flow/Triage
>
>
> 🔤 FIRST COMES FIRST
>
> What happens is some people say that having everything in one page makes
> it easier to make offline versions of the documentation. But for me it
> doesn't look a priority over having clarity.
>
>
> [image: 🐢] RUNNING LIKE THE TURTLE, NOT THE HARE
>
> Lastly, I think that it is very important to get accustomed to making
> decisions slowly in consensus.
>
> I suspect that many people like doing work in the computer because they
> can make plenty of decisions themselves, and they haven't to agree with
> others. But simply a project needs mutual agreement, and you are always
> welcome to take any decision back.
>
> This way decisions can last for a long time.
>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150330/4ca7951e/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: emoji_u1f422.png
Type: image/png
Size: 1520 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150330/4ca7951e/attachment.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: emoji_u1f425.png
Type: image/png
Size: 1259 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150330/4ca7951e/attachment-0001.png>