Please, could you give your opinion on these documentation styles?

[Alberto Salvia Novella]

Little Girl:
> I assume you would like examples of expanding the links rather than
> how someone will be using the information, since I did provide
> examples of that.

Little Girl:
 > {{{#!wiki note
 > Links used in this page:
 >   * 
[[https://wiki.ubuntu.com/One%20Hundred%20Papercuts/Software%20packages]]
 >   * 
[[https://wiki.ubuntu.com/One%20Hundred%20Papercuts/Work-flow/Triage/Fixable/rmadison]]
 >   * [[https://wiki.ubuntu.com/One%20Hundred%20Papercuts/Launchpad]]
 > }}}

These examples look like good resources. On the other hand I can't 
figure out if they fit till I know real life cases where users copy 
information from the wiki-page.


Little Girl:
 > This may seem trivial, but some pages are
 > large, quite complex, and contain many links.

This is why I favour atomization as much as possible, and not nuclear 
plants :-D


Little Girl:
 > Please keep in mind that not every task covered by the Ubuntu wiki
 > requires an online connection. In fact, I would venture to guess
 > (and hope, even!) that most don't.

My original idea is to improve documentation regarding triaging, and 
triaging needs launchpad.net.

Additionally the Internet is so widespread among the Ubuntu community 
that I cannot imagine many cases, except for individual applications, 
were having an offline copy of the documentation would help so much. But 
if you know any example, it will be nice to be aware of it.

I'm also considering an alternative, that is to use Unicode emojis 
instead; as those in 
<https://wiki.ubuntu.com/One%20Hundred%20Papercuts/Work-flow/Triage>. 
What do you think of this?

The problem is they are only supported by default starting by Utopic, 
and in the latest Android devices. In the rest of systems, the page 
shows a tofu character.


Little Girl:
 > Not this brain. (:

:o  oh!



-------------- 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/20141017/061c7970/attachment.bin>