[wiki] PAE page: formatting and flavor-agnosticism

[Alberto Salvia Novella]

Pasi Lallinaho:
> What do you think?

🐥 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.


🐢 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 --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 3748 bytes
Desc: S/MIME Cryptographic Signature
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150329/da13bfe1/attachment.bin>