- New implementation is in the docgen backend, not the internal backend, because repos might want to generate their own reference and builddict, that knows about their custom plugins.

Review Request #3315 — Created Jan. 8, 2016 and submitted — Latest diff uploaded

benjyw
pants
pants-reviews
- However our internal sitegen is modified to use this new docgen too,
  of course. To support this, two versions are generated: a standalone
  page (by default), and version suitable for embedding in the
  pantsbuild.github.io docs.

- The new pages have some minimal javascript, so they can expand/collapse
  sections of the doc.

- We only generate HTML pages. The old builddict generator also generated
  RST docs, but we didn't use them anywhere in practice.

CI passes: https://travis-ci.org/pantsbuild/pants/builds/100655484

Manually generated docs. See embedded versions here:

https://benjyw.github.io/pants/doc/docsite/build_dictionary.html
https://benjyw.github.io/pants/doc/docsite/reference.html

See standalone versions here:

https://benjyw.github.io/pants/doc/reference/build_dictionary.html
https://benjyw.github.io/pants/doc/reference/pants_reference.html

Loading...