The Bugsquad documentation , from Wiki to PDF
Mathieu Comandon
strycore at gmail.com
Mon Jan 25 00:54:19 UTC 2010
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hello Bug Squad team
I wanted to get more involved with the Bug Squad but I've always found
it hard to get anything from the Wiki. I always get to the point where
I have more than 10 open tabs on Firefox and I rarely finish reading
any page. There's always an hyperlink getting in the way, begging to
be clicked, promising new hidden knowledge.
On my agenda I had planned to read every single page from the Bug
Squad knowledge base, but it still didn't help. So I started making a
flat document out of all this documentation. I like books or PDFs more
than Wikis, especially if there's a lot to learn. Books have a start
and an end, you can continue where you left when you stopped reading,
you're not reading 10 pages at the same time and you know how many
pages are left before you finish.
I try putting pages in a coherent order and I avoid making forward
references. Besides reorganizing the pages, I also format the pages so
that they look good in Open Office, remove hyperlinks when they are
not necessary or put them as footnotes. I intend to add every page
from https://wiki.ubuntu.com/CategoryBugSquad in this document (except
IRC logs). There might be a few pages that are not related to bug
management if necessary (i.e. from CategoryUbuntuDevelopment ).
This is also a very good way for me to learn about dealing with bugs
in Ubuntu. Bug Triage won't have any secrets for me when I finish this ;)
When it's ready, it might be a good idea to make a deb package out of
it and include it in the repos.
A sneak preview of the work done so far can be fetched here :
http://strycore.com/ubuntu-bugs.pdf
Hope you like the idea :)
Mathieu
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iEYEARECAAYFAktc67sACgkQa0F+7SVw2RKpCACeIAV2deaY7PlIW3oniM0W1R4Q
/gEAn2hm/NNTS5hClew4p4fMpB8MIS3/
=r/Jk
-----END PGP SIGNATURE-----
More information about the Ubuntu-bugsquad
mailing list