Mike Danese
826f89d11d
glide: add k8s deps
|
8 years ago | |
|---|---|---|
| .. | ||
| testdata | 8 years ago | |
| README.md | 8 years ago | |
| analytics.go | 8 years ago | |
| analytics_test.go | 8 years ago | |
| example_syncer.go | 8 years ago | |
| example_syncer_test.go | 8 years ago | |
| headers.go | 8 years ago | |
| headers_test.go | 8 years ago | |
| kubectl_dash_f.go | 8 years ago | |
| kubectl_dash_f_test.go | 8 years ago | |
| links.go | 8 years ago | |
| links_test.go | 8 years ago | |
| mungedocs.go | 8 years ago | |
| preformatted.go | 8 years ago | |
| preformatted_test.go | 8 years ago | |
| toc.go | 8 years ago | |
| toc_test.go | 8 years ago | |
| unversioned_warning.go | 8 years ago | |
| unversioned_warning_test.go | 8 years ago | |
| util.go | 8 years ago | |
| util_test.go | 8 years ago | |
| whitespace.go | 8 years ago | |
| whitespace_test.go | 8 years ago | |
README.md
Documentation Mungers
Basically this is like lint/gofmt for md docs.
It basically does the following:
- iterate over all files in the given doc root.
- for each file split it into a slice (mungeLines) of lines (mungeLine)
- a mungeline has metadata about each line typically determined by a 'fast' regex.
- metadata contains things like 'is inside a preformmatted block'
- contains a markdown header
- has a link to another file
- etc..
- if you have a really slow regex with a lot of backtracking you might want to write a fast one to limit how often you run the slow one.
- each munger is then called in turn
- they are given the mungeLines
- they create an entirely new set of mungeLines with their modifications
- the new set is returned
- the new set is then fed into the next munger.
- in the end we might commit the end mungeLines to the file or not (--verify)
[]()