what happened to the comment sections in the documentation pages?

Latest response

Being able to make comments visible on the documentation pages was invaluable. Where did it go? There are a lot of places where our documentation could be more accurate or complete and the comments allowed this to be mitigated immediately. Case in point: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html/manual_installation_procedures/sect-tempest-configure:

This statement:
tools/config_tempest.py --debug --create identity.uri OS_AUTH_URLidentity.admin_username OS_USERNAME identity.admin_password OS_PASSWORD identity.admin_tenant_name OS_TENANT_NAME object-storage.operator_role Member

has a number of issues: it is missing a space after 'OS_AUTH_URL and the environment variables need a '$'. So it should be:

tools/config_tempest.py --debug --create identity.uri $OS_AUTH_URL identity.admin_username $OS_USERNAME identity.admin_password $OS_PASSWORD identity.admin_tenant_name $OS_TENANT_NAME object-storage.operator_role Member

I have no place to give that feedback now. I say bring back the comments!!!

CF

Responses