I'd like to ask the docs team if they see the possibility to have
reviews of the merged config options help texts Nova has updated in the
last months.

Background: In Mitaka and Newton, Nova put a lot of effort in providing
valuable help texts for their config options. They are written from
developers for operators. My assumption is, that technical writers like
the docs team look at them differently. As these help texts get
extracted from the code and will be used directly in the "configuration
reference" manual, the text "by-passed" the writing expertise of the
docs team.

Be aware, that this is still an ongoing effort in Nova (see [1],
especially "needs:fix_opt_description").

References:
[1] http://45.55.105.55:8082/config-options.html

-- 
Regards, Markus Zoeller (markus_z)


__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to