On 08/01/2012 04:10 PM, Pasi Lallinaho wrote:
Hello Xubuntu documentation enthusiasts!
It's time for the next step in the documentation rewrite. Those who
signed up as *Writers*or *Technical Editors*, it's time for you to
shine! Soon, *Grammar Editors*can chime in too!
There are few things we need to get sorted out next. These are listed
underneath. The roles in the parenthesis mean the primary groups that
should undertake these tasks, but you can help out even if you didn't
list in that group too.
What we need to do now is:
-- Copy the current documentation to the wiki (Everybody, where
applicable)
-- Review the documentation structure (Technical Editors)
-- Is the documentation structure good, or should we reorganize?
(Technical Editors)
--Do we have any redundant information in the documentation?
(Technical Editors)
--Should we add something else to the documentation? (Technical Editors)
-- Does the documentation match the current state or applications?
(Technical Editors)
--If not; rewrite the section and once the sections are rewritten,
check them for grammar errors (Writers, Grammar Editors)
--If yes; make sure it's clearly written and check for possible
grammar errors (Grammar Editors)
We have put together a temporary wiki for this work to be done on
here: http://dagobah.princessleia.com/Xubuntu. We've set up a few
sections as examples on how to add the content to the wiki. Follow the
examples, or if you think you can do it better, feel free to!
Please don't beshy about starting edits, but keep in mind that this is
collaborative so you will want to coordinate with other documentation
writers on the xubuntu-devel mailing list when discussing deletions or
major changes to sections. You may also consider splitting up
"ownership" of the sections so only one person is working on them at
once, that's up to you --the docs team!
The original documentation can be found in Docbook format at
https://code.launchpad.net/xubuntu-docs(useful for those who want to
learn Docbook -- those who signed up as Docbook Editors). If you're
scared of Docbook, you can also use the offline menu in your
installation; just navigatie to Help in the applications menuand it
will bring up the documentation in a web browser.
Finally, please note that Xubuntu does not currently have
Documentation Lead, which means we're feeling our way here and just
beginning to build upwhat the documentationinfrastructure and the
conventions are. Suggestions welcome!(Eventually, we might pick a
Documentation Lead if there is people willing and able to take that
position.)
However, if any kind of questions or disputes arise, you are very
welcome to send email to the xubuntu-devel mailing list. Ultimately,
there are two people resolving disputes and other issues; Pasi
Lallinaho, the Project Lead and Elizabeth Krumbach, the Marketing Lead.
Please note that it's summer time in the northern hemisphere so we
have a lot of project members traveling and generally just having
holidays in the coming weeks and we don't want anyone feeling held up
because they didn't get a response.
Cheers,
Pasi
--
Pasi Lallinaho (knome) »http://open.knome.fi/
Leader of Shimmer Project and Xubuntu »http://shimmerproject.org/
Graphic artist, webdesigner, Ubuntu member »http://xubuntu.org/
Went on #xubuntu-devel this morning. Don't think that I have what it
takes to do Docbook rewrites, but if you need any writers or grammar
editors, I would very much like to contribute.
Thanks. rd - amerigena
--
xubuntu-devel mailing list
xubuntu-devel@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/xubuntu-devel
