On 07/07/2015 04:44 PM, Jeremy Stanley wrote:
On 2015-07-07 13:24:00 +0100 (+0100), Dave Walker wrote:
[...]
I am interested to hear why the convention in documentation for it to
be lower case.
[...]
Seems like this question comes up once for every two or three new
writers/editors who join the Docs effort. The most recent thread on
it is from last month.
http://lists.openstack.org/pipermail/openstack-docs/2015-June/006796.html
To summarize my understanding:
1. You should just avoid using project codenames in documentation,
in favor of official project names (e.g., use Compute rather
than nova) whenever possible.
With big tent we no longer have official names for every official
project.. E.g. Ironic has also Ironic Python Agent (or ironic python
agent?), Bifrost (or bifrost?) and Ironic Inspector (or ironic inspector?).
2. There are concerns that capitalized use of project codenames
makes them more likely to present a high-profile/infringing
target for intellectual property (trademark, et cetera) claims.
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: [email protected]?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
