Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use a builder-agnostic TOC reference in user-guide.html #476

Merged

Conversation

smashwilson
Copy link
Contributor

Content repositories rendered with the user-guide.html template will fall back to the local TOC if no repository-wide TOC is available. This prevents the TOC from disappearing when the routed template is changed before a content repository's builder is changed to match, as happened in rackerlabs/docs-cloud-load-balancers#134.

@meker12 : This should make it easier to transition content repositories from the deconst-single builder to deconst-serial without losing the TOC in the middle. To gracefully change a repository:

  1. Submit and merge a pull request to nexus-control updating config/routes.d/<site>.json to change the template for the content repository from docs-singlepage.html to user-guide.html.
  2. Submit and merge a pull request against the content repository changing the builder specified in conf.py from deconst-single to deconst-serial.

@smashwilson smashwilson self-assigned this Jun 1, 2016
@smashwilson smashwilson merged commit fa028d1 into rackerlabs:master Jun 1, 2016
@smashwilson smashwilson deleted the builder-agnostic-template branch June 1, 2016 14:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant