- 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. 7, 2016 and submitted

Information
Benjy Weinberger
pants
Reviewers
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

Eric Ayers
Benjy Weinberger
Review request changed

Status: Closed (submitted)

Change Summary:

Submitted as 49d8b37be27d9f5e236510c9af4fe01a762388c9.

Benjy Weinberger

Thanks Eric! Sorry for the diff confusion. Submitted as 49d8b37be27d9f5e236510c9af4fe01a762388c9.

Loading...