diff --git a/doc/source/faq.rst b/doc/source/faq.rst new file mode 100644 index 00000000..3325e40e --- /dev/null +++ b/doc/source/faq.rst @@ -0,0 +1,30 @@ +============================ + Frequently Asked Questions +============================ + +Why does oslo.config have a CONF object? Global objects SUCK! +============================================================= + +.. original source: https://wiki.openstack.org/wiki/Oslo#Why_does_oslo.config_have_a_CONF_object.3F_Global_object_SUCK.21 + +Indeed. Well, it's a long story and well documented in mailing list +archives if anyone cares to dig up some links. + +Around the time of the Folsom Design Summit, an attempt was made to +remove our dependence on a global object like this. There was massive +debate and, in the end, the rough consensus was to stick with using +this approach. + +Nova, through its use of the gflags library, used this approach from +`commit zero +`__. Some +OpenStack projects didn't initially use this approach, but most now +do. The idea is that having all projects use the same approach is more +important than the objections to the approach. Sharing code between +projects is great, but by also having projects use the same idioms for +stuff like this it makes it much easier for people to work on multiple +projects. + +This debate will probably never completely go away, though. See `this +latest discussion in August, 2014 +`__ diff --git a/doc/source/index.rst b/doc/source/index.rst index 6715bd4f..01f59366 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -22,6 +22,7 @@ Contents namespaces styleguide generator + faq contributing Release Notes