Hi everyone!<div><br></div><div>First post here...</div><div><br></div><div>As a communicator, I'd advise you to stick to that split-up plan. Defining specific audiences to target is definitely the soundest first step. </div>
<div><br></div><div>Then you should probably split the app in task-related logical blocks, following the path each user group has to follow to complete tasks in the app. Have some volunteer noobs test the app -as users, devs or admins- and write down every inconsistency or question. You probably have a lot of these info in your forum, but sistematizing it according to the logical blocks I mentioned should also help any current or future UX team. </div>
<div><br></div><div>And those blocks and their corresponding taskpaths are your chapters and subchapters. By now you should have sections and titles consistently structured. Add content -and images!- and you're on. </div>
<div><br></div><div>Iterate. Often. </div><div><br></div><div>Hope it helps!</div><div><br></div><div>Cheers, </div><div><br></div><div><br></div><div>chepi </div><div><br></div><div><br><br><div class="gmail_quote">On Fri, May 14, 2010 at 11:21 AM, RedMight Muntek <span dir="ltr"><<a href="mailto:Muntek@redmight.com">Muntek@redmight.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">








<div lang="EN-US" link="blue" vlink="purple">

<div>

<p class="MsoNormal">Howdy!</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">I have been a heavy user of a FLOSS (GPL v2) project for
several years now, but only recently have I become more involved. I have been
pushing heavily for more "open-nes" and my efforts have paid off in
the creation of "teams" to lead separate areas of
development/support.</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">Say hello to the new Documentation Team Leader :)</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">Unfortunately I'm definitely not a writer nor a
documentation expert. I have used some FLOSS Manuals from you guys before, and
have thought them to be most excellent so I come here looking for help and
advice. </p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">Currently the project has a hodge-podge of varying quality
documentation spread across a wiki, a forum, and an issue tracker. I'm looking
for suggestions and best practices on how I should go about reorganizing, restructuring,
and creating all the current and needed stuff into a cohesive set of useful and
consistent documentation.</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">The Project is Redmine - <a href="http://redmine.org" target="_blank">http://redmine.org</a> . We just had a
meeting of team leaders ( <a href="http://www.redmine.org/projects/redmine/wiki/Teams" target="_blank">http://www.redmine.org/projects/redmine/wiki/Teams</a> )
and have agreed to have Book sprint in July. Prior to that still need to get
things prepared, and some semblance of organization created. I'm looking to
split the docs into three areas - For Developers, For Administrators, and For
users.</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">Any help, advice, tips, or suggestions anyone is willing to
give would be much appreciated!</p>

<p class="MsoNormal"> </p>

<p class="MsoNormal">Thanks!</p>

</div>

</div>


<br>_______________________________________________<br>
Discuss mailing list<br>
<a href="mailto:Discuss@lists.flossmanuals.net">Discuss@lists.flossmanuals.net</a><br>
<a href="http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net" target="_blank">http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net</a><br>
<br></blockquote></div><br></div>