another major factor to consider is having the formatting compatible with mobile devices. It is quite terrible right now with long sentences not being word wrapped so you have to scroll for miles and then scroll back when the sentence ends.<div>
<br></div><div>Ok, so we have lots of ideas for improvements. I'm wondering if we should strike a committee to accept, organize and review proposals and present the findings in a few weeks.</div><div><br></div><div>kesten<br>
<br><div class="gmail_quote">On Fri, Jan 11, 2013 at 12:54 AM, Jared Reisweber <span dir="ltr"><<a href="mailto:jaredr122@gmail.com" target="_blank">jaredr122@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I'd like to chime in, as an editor who has seen a lot of wiki pages,<br>I don't completely agree with your level of simplification, but I agree that some of the wiki formatting is distracting and hard to read. I think the bigger problem is the inconsistency of the use of formatting, which stems from the fact that there is no real standard for the way pages are formatted (for example, when to use bullets, or what should be bold, or when to make a sub-heading). I think we should decide on some standards that would encompass anything that would be in the manual.<br>
<br>The second problem is the actual formatting. It is hard to read. I had suggested to Kesten about the use of indentation, which is fairy common in documentation that I've seen. I also am in favor of color formatting(see Autodesk's documentation). I think in addition to standardizing formatting, we need to revise the formatting style so that it makes pages easier to read and understand. I'm thinking these things should be discussed thoroughly before going and changing all the manual pages.<br>
<br>Here are some examples from Houdini's documentation, which is easy to read:<br><br><a href="http://www.sidefx.com/docs/houdini11.0/model/polys" target="_blank">http://www.sidefx.com/docs/houdini11.0/model/polys</a><br>
<a href="http://www.sidefx.com/docs/houdini11.0/light/shadows" target="_blank">http://www.sidefx.com/docs/houdini11.0/light/shadows</a><br>
<br><br><br><div class="gmail_quote"><div><div class="h5">On Thu, Jan 10, 2013 at 6:11 PM, Cal McGaugh <span dir="ltr"><<a href="mailto:cal@cal3d.com" target="_blank">cal@cal3d.com</a>></span> wrote:<br></div></div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5">
<u></u>
<div>
<div>
Well this is embarrassing......meant it only for Keston for now......my apologies.
</div>
<div>
</div>
<div>
But would appreciate any feedback from the group as well.
</div>
<div>
</div>
<div>
Thanks,
</div>
<div>
Cal McGaugh (noob)
</div>
</div><br></div></div>_______________________________________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org" target="_blank">Bf-docboard@blender.org</a><br>
<a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
<br></blockquote></div><br>
<br>_______________________________________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
<a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><br>Kesten Broughton<br>President and Technology Director, <br>Solar Mobile Trailers<br><a href="http://www.sunfarmkitchens.ca" target="_blank">kesten@solarmobiletrailers.com<br>
www.sunfarmkitchens.ca</a><br>512 701 4209<br><div style="display:inline"></div>
</div>