Comment 4 for bug 1580997

During the May 2017 OpenStack summit I spoke to cdent and a few others about whether we should be allowed to remove the unexpected URLs without a microversion bump, once I explained the problem with doing so - routes in pecan are generated using the function definitions which are processed before the microversion being requested can be processed - they seemed to agree that it might be an exception to the general rule but might need more research and might not be worth the time it'll take to fix it.

If we decide not to fix it, then I wonder what we should do with the documentation, should we document the APIs that really exist or the APIs that we want people to use?

We should at least document the node names that you can't use because they collide with the special APIs like states/ports etc.