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