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">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><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<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>_______________________________________________<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>