Thanks Anne,<br><br>That's just what I was looking for.<br><br>Michael<br><br><div class="gmail_quote">2009/5/28 Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>></span><br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Hi Michael - <br>For the SugarLabs/OLPC books, we use the "Writing Conventions" link for the book as our style guide and contribution guide. From this page, <a href="http://en.flossmanuals.net/bin/view/XO/WebHome" target="_blank">http://en.flossmanuals.net/bin/view/XO/WebHome</a>, click "<a href="http://en.flossmanuals.net/bin/view/XO/WritingConventions" target="_blank">Agreed conventions for writing this manual</a>"<br>
<a href="http://en.flossmanuals.net/bin/view/XO/WritingConventions" target="_blank">http://en.flossmanuals.net/bin/view/XO/WritingConventions</a>. Is this the type of style guide you're thinking of?<br><br>I think style guidance is very useful to get consistent, quality results. Plus anyone approaching the manual has an idea of the conventions used to write it and can contribute more quickly. <br>
<br>Hope this helps,<br>Anne<br><blockquote style="margin: 1.5em 0pt;"><table><tbody><tr><td>
<br>
</td><td></td><td>
<div style="padding: 5px; font-size: 11px; color: rgb(102, 102, 102); font-family: sans-serif;"><b>Anne Gentle</b>
<br>
<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
<div style="font-size: 10px;">
<a href="http://justwriteclick.com" target="_blank">my blog</a> |
<a href="http://xmlpress.net/publications/conversation-community/" target="_blank">my book</a> |
<a href="http://twitter.com/annegentle" target="_blank">Twitter</a>
</div></div></td></tr><tr></tr></tbody></table></blockquote><br><br><div class="gmail_quote"><div><div></div><div class="h5">On Thu, May 28, 2009 at 7:38 AM, Michael McAndrew <span dir="ltr"><<a href="mailto:michaelmcandrew@gmail.com" target="_blank">michaelmcandrew@gmail.com</a>></span> wrote:<br>
</div></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div><div></div><div class="h5">Hi all,<br><br>During/after the CiviCRM book sprint we coalesced - to a certain extent at least - around a specific style that gives the CiviCRM book some coherence.<br>
<br>I think it would be useful to make this explicit somewhere as an aid to people that want to contribute. We could add to the 'How to contribute to this manual' section. But it might sit better outside of the flow of the book.<br>
<br>I wondered if any other books have had similar thoughts and experience. And if anyone has ideas about how the floss manuals infrastructure can help us do this / ideological objections to style guides?<br><br>Cheers,<br>
<font color="#888888">
<br>Michael
</font><br></div></div>_______________________________________________<br>
Discuss mailing list<br>
<a href="mailto:Discuss@lists.flossmanuals.net" target="_blank">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>
<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>