Address TODOs in apimanual.md

[mlubin]

[Discuss how models are constructed, optimizer attributes.]
[Define notation more precisely. ``a`` vector; ``A`` matrix; don't reuse ``u,l,b`` as scalar and vector]
[ needs formatting help, doc tests ]