<tt><font size=2>Zane Bitter <zbitter@redhat.com> wrote on 02/21/2014
12:23:05 PM:<br>
<br>
> Yeah, we are overloading the term 'developer' here, since that section
<br>
> contains both information that is only useful to developers working
on <br>
> Heat itself, and information useful to users developing templates.</font></tt>
<br>
<br><tt><font size=2>At the highest levels of the OpenStack documentation,
a distinction is made between cloud users, cloud admins, and developers.
 Nobody coming at this from the outside would look under developer
documentation for what a cloud user --- even one writing a Heat template
--- needs to know: cloud users are obviously application developers and
deployers and operators.</font></tt>
<br><tt><font size=2><br>
> I'm not sure if this is forced because of an OpenStack-wide assumption
<br>
> that there is only API documentation and developer documentation?<br>
> <br>
> We ought to split these up and make the difference clear if we can.<br>
</font></tt>
<br><tt><font size=2>Forget the "if".  If we don't want
to have to mentor every new user, we need decent documentation.</font></tt>
<br>
<br><a href="https://bugs.launchpad.net/openstack-manuals/+bug/1281691"><tt><font size=2>https://bugs.launchpad.net/openstack-manuals/+bug/1281691</font></tt></a>
<br>
<br><tt><font size=2>Regards,</font></tt>
<br><tt><font size=2>Mike</font></tt>