[openstack-dev] [nova] [docs] Scheduler filters documentation

Sylvain Bauza sbauza at redhat.com
Wed Apr 29 19:08:06 UTC 2015


A good comment has been provided to 
https://review.openstack.org/#/c/177824/1 by saying that the reference 
docs [1] are duplicate to the Nova devref section [2]

As I also think it is error-prone to keep two separate informations 
about how Scheduler filters, I would like to discuss on how we could 
make sure both are in sync.
Since the developers owe to provide how to use the filters they write, 
my preference goes to keep updating the Nova devref page each time a 
filter behaviour is changed or a new filter is created and consequently 
make sure that the reference docs is pointing to that devref page, using 
an iframe or whatever else.

Of course, each time that a behavioural change is provided, that's also 
the developer's duty to provide a DocImpact tag in order to make sure 
that docs people are aware of the change.

Thoughts ?
-Sylvain

[1] 
http://docs.openstack.org/juno/config-reference/content/section_compute-scheduler.html#aggregate-instanceextraspecsfilter
[2] 
http://docs.openstack.org/developer/nova/devref/filter_scheduler.html#filtering






More information about the OpenStack-dev mailing list