Documentation; GO!

Rich Dennis rdennis at
Wed Aug 29 10:56:23 UTC 2012

On 08/29/2012 01:37 AM, Pasi Lallinaho wrote:
> On 08/29/2012 01:35 AM, Rich Dennis wrote:
>> 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: 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 
>>> 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)                      »
>>> Leader of Shimmer Project and Xubuntu       »
>>> Graphic artist, webdesigner, Ubuntu member  »
>> 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
> Help with writing and that stuff is welcome too! See the first part of 
> my last mail [1] for a quick introduction to the current situation and 
> you are ready to start working.
> Cheers,
> Pasi
> [1] 
> -- 
> Pasi Lallinaho (knome)                      »
> Leader of Shimmer Project and Xubuntu       »
> Graphic artist, webdesigner, Ubuntu member  »
Thank you. Got started last night on the Network -> Troubleshooting 
section of the wiki.
Didn't make too many changes - thought that I'd start slow and make sure 
that they're acceptable.
Thanks for getting back to me.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <>

More information about the xubuntu-devel mailing list