Second examples listed in TOC for docs for rack
kenperkins opened this issue · comments
https://developer.rackspace.com/docs/rack-cli/services/#examples-for-services
In the left rail you can see a second set of examples listed:
@ktbartholomew could this be a deconst/template problem?
It looks like the TOC's are duplicated in the source: https://raw.githubusercontent.com/rackspace/rack/master/docs/services/examples/index.rst
@ktbartholomew But it was working up until today I think. I merged some changes but not there. It looks like you added those tocs a while back: https://github.com/rackspace/rack/blame/master/docs/services/examples/index.rst
I don't know anything about the formatting/syntax for these, but is the :hidden: not being acknowledged?
@smashwilson has been most active with the preparers lately, maybe he can weigh in on this.
We just turned on the Strider build yesterday, so it wasn't being published automatically until then. Has anyone been manually submitting content in the interim? Otherwise, it's likely that the TOC changes from before have just now been published.
The preparer work I've been doing lately has mostly been in output formatting, writing assets and envelopes to disk instead of over the network. I wouldn't rule out preparer changes as a culprit but nothing jumps out at me right now.
What I'd really like to do is revamp the way we generate TOCs in Sphinx entirely to not require the phony _toc.rst file at all. That's going to be difficult, though.
I've been publishing the docs to production, but only for the rack releases.
Ah, okay, good.
I'll double-check in the preparer... either way, not respecting :hidden: feels like a preparer bug to me.
@smashwilson Were you able to determine if this is a bug in the preparer? If not (or if it isn't), I can look into ways of changing the docs to de-dupe the TOC. I'm not sure whether we need the :hidden: TOC there or not.
Well, I'm rewriting the way that TOCs are generated entirely with deconst/preparer-sphinx#64. I haven't worked my way back to this specific case yet 😉
But, I am guessing that the problem is the two .. toctree directives in docs/services/index.rst. Try nixing the :hidden: one - the document structure will be preserved by the other two toctrees.
Try nixing the :hidden: one
Will do. With the ability to preview the docs in staging, I can safely just guess and check until I find something that works.
by #437
Excellent.
No idea why it was only rendering once before, though.
No idea why it was only rendering once before, though.
Yeah, nor I. Oh well. Just another unsolved mystery...