<div dir="ltr"><div>I tried to give people a link to string.format() documentation</div><div>and found that there is no good example or user reference.</div><div><br></div><a href="https://docs.python.org/2/library/string.html#formatspec">https://docs.python.org/2/library/string.html#formatspec</a><div>

- what this does first is confuses people, because it is too</div><div>abstract and goes deep into some awkward BNF, then lists</div><div>a lot of letters, and only then, in the next chapter, is the</div><div>example.</div>

<div><br></div><div>It looks like the order is reversed from the usual way people</div><div>look:</div><div>1. example</div><div>2. overview</div><div>3. user details</div><div>4. developer details</div><div><br></div><div>

<br></div><div>I am not aware of any kind of optional documentation writing</div><div>guide for Python? Maybe it is a good way to write one? I</div><div>know many people are aware of WriteTheDocs. What people</div><div>there say about issues such as this? Is there a systematic</div>

<div>approach to heal that?</div><div><div><br></div>-- <br>anatoly t.
</div></div>