<div class="gmail_quote">On Fri, Apr 6, 2012 at 3:25 AM, <span dir="ltr"><<a href="mailto:spage@monkeybrains.net">spage@monkeybrains.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
> Rather than FLOSS Manuals, "chapters" will be hosted at<br>
> <a href="http://wiki.sugarlabs.org" target="_blank">http://wiki.sugarlabs.org</a> and <a href="http://wiki.laptop.org" target="_blank">http://wiki.laptop.org</a> using WISYWIG<br>
> plugins (SJ&BernieI will each try to install today)<br>
<br>
> Chapters MUST abide by Style Guide to be posted today, so<br>
> screenshots/grammar flow (Seth & Christoph)<br>
<br>
There is already a style guide for the wiki,<br>
<a href="http://wiki.laptop.org/go/OLPC:Style_guide" target="_blank">http://wiki.laptop.org/go/OLPC:Style_guide</a> , and Help Activity Refresh<br>
wasn't following it.<br>
<br>
* Don't use H1 headings, i.e. start with == My heading ==, not =This<br>
appears as H1=. The page title is an H1, and should be the only one on the<br>
page.<br>
<br>
* Don't overcapitalize. Only capitalize the first word of a title.<br>
Section headings like "Procedures on Porting/Assembling the Manual into<br>
Help Activity" just sound Officious and Wordy. "Help Activity" is<br>
arguably appropriate capitalization, but other words should not be<br>
capitalized.<br>
I fixed these, if anyone strongly disagrees you can revert, but man up and<br>
change the style guide.<br>
<br>
Looking at <a href="http://laptop.org/manual" target="_blank">laptop.org/manual</a>, it's inconsistent. Its Chapter titles<br>
Capitalize Each Word, but sections Only capitalize the first word, like<br>
the wiki. (The Flossmanuals house style turns the entire TOC into AN<br>
ILLEGIBLE ALL CAPS WHITE ON ORANGE, but that's a separate issue).<br>
<br>
Good luck with the doc sprint! I'll try to check in and offer wiki help.<br></blockquote><div><br></div><div>Personally I'm for option #4 "Lots of Capitalized Words" but maybe that's just my native German determining my thinking... ;-)</div>
<div><br>Christoph</div></div><div><br></div>-- <br>Christoph Derndorfer<div><br></div><div><div>volunteer, OLPC (Austria) [<a href="http://www.olpc.at/" target="_blank">www.olpc.at</a>]<br><div>editor, OLPC News [<a href="http://www.olpcnews.com/" target="_blank">www.olpcnews.com</a>]<br>
contributor, TechnikBasteln [<a href="http://www.technikbasteln.net/" target="_blank">www.technikbasteln.net</a>]</div></div><div><br></div><div>e-mail: <a href="mailto:christoph@derndorfer.eu" target="_blank">christoph@derndorfer.eu</a></div>
</div><br>