<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/29/2012 01:35 AM, Rich Dennis
wrote:<br>
</div>
<blockquote cite="mid:503D47B3.2070305@shorelancs.com" type="cite">
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
<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>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
<br>
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.<br>
<br>
Cheers,<br>
Pasi<br>
<br>
[1]
<a class="moz-txt-link-freetext" href="https://lists.ubuntu.com/archives/xubuntu-devel/2012-August/008392.html">https://lists.ubuntu.com/archives/xubuntu-devel/2012-August/008392.html</a><br>
<br>
<pre class="moz-signature" cols="72">--
Pasi Lallinaho (knome) » <a class="moz-txt-link-freetext" href="http://open.knome.fi/">http://open.knome.fi/</a>
Leader of Shimmer Project and Xubuntu » <a class="moz-txt-link-freetext" href="http://shimmerproject.org/">http://shimmerproject.org/</a>
Graphic artist, webdesigner, Ubuntu member » <a class="moz-txt-link-freetext" href="http://xubuntu.org/">http://xubuntu.org/</a></pre>
</body>
</html>