<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 08/01/2012 04:10 PM, Pasi Lallinaho
wrote:<br>
</div>
<blockquote cite="mid:50198D41.1000206@shimmerproject.org"
type="cite">
<meta http-equiv="content-type" content="text/html;
charset=ISO-8859-1">
<div class="" id="magicdomid2"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">Hello Xubuntu
documentation enthusiasts!</span></div>
<div class="" id="magicdomid3"><br>
</div>
<div class="" id="magicdomid4"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">It's time for
the next step in the documentation rewrite. Those who signed
up as </span><b><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n b">Writers</span></b><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> or </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n b"><b>Technical
Editors</b></span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">, it's time
for you to shine! Soon, </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n b"><b>Grammar
Editors</b></span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> can chime in
too!</span></div>
<div class="" id="magicdomid5"><br>
</div>
<div class="" id="magicdomid6"><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">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.</span></div>
<div class="" id="magicdomid7"><br>
</div>
<div class="" id="magicdomid8"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">What we need
to do now is:</span></div>
<div class="" id="magicdomid9"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">– Copy the
current documentation to the wiki (</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">Everybody,
where applicable</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid10"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">– Review the
documentation structure (T</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">echnical
Editors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid11"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> – Is the
documentation structure good, or should we reorganize? (T</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">echnical
</span><span class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">E</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">ditors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid12"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">–</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> Do we have
any redundant information in the documentation? (T</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">echnical
Editors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid13"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">–</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> Should we
add something else to the documentation? (T</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">echnical
Editors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid14"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">– Does the
documentation match the current state or applications? (T</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">echnical
</span><span class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">E</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">ditors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid15"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">–</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> If not;
rewrite the section and once the sections are rewritten, check
them for grammar errors (W</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">riters</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">, G</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">rammar </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">E</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">ditors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid16"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">–</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> If yes; make
sure it's clearly written and check for possible grammar
errors (G</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">rammar </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">E</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">ditors</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">)</span></div>
<div class="" id="magicdomid17"><br>
</div>
<div class="" id="magicdomid18"><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z">We have
put together a temporary wiki for this work to be done on
here: </span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z url"><a
moz-do-not-send="true"
href="http://dagobah.princessleia.com/Xubuntu">http://dagobah.princessleia.com/Xubuntu</a></span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">. 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!</span></div>
<div class="" id="magicdomid19"><br>
</div>
<div class="" id="magicdomid20"><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z">Please
don't b</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">e</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z"> shy 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 </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">–</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z"> the docs
team!</span></div>
<div class="" id="magicdomid21"><br>
</div>
<div class="" id="magicdomid22"><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">The original
documentation can be found in Docbook format at </span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n url"><a
moz-do-not-send="true"
href="https://code.launchpad.net/xubuntu-docs">https://code.launchpad.net/xubuntu-docs</a></span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n"> (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 menu</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z"> and it
will bring up the documentation in a web browser</span><span
class="author-a-7z66zz86zs2z80zdc228z87z7z90z0n">.</span></div>
<div class="" id="magicdomid23"><br>
</div>
<div class="" id="magicdomid24"><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">Finally,
please note that Xubuntu does not currently have Documentation
Lead, which means we're feeling our way here and just
beginning to build up</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z"> what the
documentation</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">
infrastructure and the conventions ar</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z">e</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">. </span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z">Suggestions
welcome!</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">
(Eventually, we might pick a Documentation Lead if there is
people willing and able to take that position.)</span></div>
<div class="" id="magicdomid25"><br>
</div>
<div class="" id="magicdomid26"><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">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.</span></div>
<div class="" id="magicdomid27"><br>
</div>
<div class="" id="magicdomid28"><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">Please
note t</span><span
class="author-a-z89zpl5xjz65zmz71z0vyz65zz82zez74z">ha</span><span
class="author-a-z70z2z75zdxpz67zz83zjz71zk9z122z3bs">t 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.<br>
<br>
Cheers,<br>
Pasi</span><br>
<pre class="moz-signature" cols="72">--
Pasi Lallinaho (knome) » <a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://open.knome.fi/">http://open.knome.fi/</a>
Leader of Shimmer Project and Xubuntu » <a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://shimmerproject.org/">http://shimmerproject.org/</a>
Graphic artist, webdesigner, Ubuntu member » <a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://xubuntu.org/">http://xubuntu.org/</a></pre>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
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.<br>
Thanks. rd - amerigena<br>
</body>
</html>