<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:37 AM, Pasi Lallinaho
wrote:<br>
</div>
<blockquote cite="mid:503DAAA9.5040205@shimmerproject.org"
type="cite">
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
<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 moz-do-not-send="true" 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 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>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
Thank you. Got started last night on the Network ->
Troubleshooting section of the wiki.<br>
Didn't make too many changes - thought that I'd start slow and make
sure that they're acceptable.<br>
Thanks for getting back to me.<br>
amerigena<br>
</body>
</html>