Documentation; GO!

[Pasi Lallinaho]

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: 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
>
>

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] https://lists.ubuntu.com/archives/xubuntu-devel/2012-August/008392.html

-- 
Pasi Lallinaho (knome)                      » http://open.knome.fi/
Leader of Shimmer Project and Xubuntu       » http://shimmerproject.org/
Graphic artist, webdesigner, Ubuntu member  » http://xubuntu.org/

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/xubuntu-devel/attachments/20120829/1c934c61/attachment.html>