Commit Graph

70 Commits (73b547a8f512be74dc4b00473d27a439925ded02)

Author SHA1 Message Date
Janet Kuo 2498f93938 MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
Brian Grant 786b59427d Merge pull request #11400 from lavalamp/munger
Add absolute path link checking to munger
2015-07-16 22:50:14 -07:00
Daniel Smith 4d1bf3a0ca absolute link checking 2015-07-16 16:23:19 -07:00
Tim Hockin f7512d007b Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
Eric Tune f1c7915d71 Merge pull request #11325 from JanetKuo/toc
Make MUNGE generated TOC bookmark work for symbols
2015-07-15 12:56:37 -07:00
Janet Kuo de755bf59b Make MUNGE generated table of contents (TOC) bookmark work when there are symbols in the headline 2015-07-15 11:26:51 -07:00
Mike Danese d4d99deb97 make mungedoc exit 1 if manual changes are needed and wire up erro message. 2015-07-15 11:20:11 -07:00
Tim Hockin 6277801f82 Change warning.png to not go through a redirect 2015-07-14 17:28:10 -07:00
Tim Hockin c4953c6287 Add an image to unversioned warnings 2015-07-14 15:28:59 -07:00
Daniel Smith bf77ecc3a9 Various munger changes
* Add analytics munger w/ munge heading
* More link autofixes
* Allow running a subset of munges
* Fix repo root detection
* Only process non-preformatted blocks
* Gendocs no longer adds the analytics link; mungedocs does that in a
  second pass.
2015-07-13 17:47:48 -07:00
Eric Tune 950b11f198 Ignore comments in code when generating ToC. 2015-07-13 15:53:05 -07:00
Tim Hockin ad8f8731b6 Use a common set of tag prefixes for munges
All munges now start with `<!-- BEGIN MUNGE:` and end with `<!-- END MUNGE:`.
This lets me (in a followup) filter them better to normalize contents during
verification of generated docs.
2015-07-13 11:23:07 -07:00
Tim Hockin 8fceb754d8 Add 'warning: is unversioned' header to all docs
Mungedocs will keep this updated in head, and it will get stricken from
releases.
2015-07-13 11:23:07 -07:00
Zach Loafman 5c894b765b Fix mungedocs for absolute paths
chdir into the parent of the docs directory, then walk docs.

Fixes #11111
2015-07-11 13:19:55 -07:00
Tim Hockin 8ff8559c4c Add util functions 2015-07-10 17:13:19 -07:00
Tim Hockin 95cd66d3a0 use 'lines []string' for updateMacroBlock 2015-07-10 17:13:19 -07:00
Tim Hockin 2e781fed49 Break util func into a new file 2015-07-10 17:13:19 -07:00
Tim Hockin 84ad1792ea Run all munges on all docs
Rather than terminating, Collect the errors and print them per-file-per-munge.
2015-07-10 17:13:19 -07:00
Daniel Smith c4aab16b04 Adds a link fixer/checker to mungedocs.
Links that don't work yet can be prefixed with "TODO:" to avoid the check.
2015-07-10 10:54:47 -07:00
Eric Tune c51e35e835 Support for in-place modification of docs
Adds cmd/mungedocs which is framework for processing
all files under docs/ and either verifying that no changes needed or
making in-place changes.

Did not reuse kube::util::gen-docs because that seemed to be
centered around handling added files, and this pass does not
add files.

Planned uses:
 - table of contents automatic updating
 - linkification
 - internal link checker
 - link-path-relativizer or absolutizer
 - example file syncer
 - header inserter.

Just table-of-contents updating in this PR.

Added Table of Contents to docs/networking.md.

Demonstrates use of new TOC generator presubmit.
Other docs will be added in future PRs.
Additional development will be needed to handle some
of the more complex cases.
2015-07-08 14:58:54 -07:00