closes #1832 The shred map (xref) builder was issuing warnings. This fix includes - Adjustments to the shredder map builder itself so that it understands, e.g., app-project relative example paths. - `**/guide/glossary.jade` now (Jade) `includes` the shared parent `glossary.jade` rather than (Harp) importing (via `partial`). This fixes `makeExample` path issues in the glossary. - Adjusted some `makeExample` paths that were ok for site build, but confused the xref tool.
Why the _fragments dir is checked in
Within this repo files generated as a result of shredding the _examples
dir ( the contents of the _fragments
dir) are checked in so that we can avoid running the
shredder over the entire _examples
dir each time someone refreshes the repo ( the shred-full
gulp task).
The gulp serve-and-watch
shredder is only a ‘partial’ shredder. It only shred’s files in directories changed during
the current session.