Open
Description
In the documentation for each tag, we need to briefly illustrate how that tag affects a doclet.
One pie-in-the-sky idea:
- Convert the code samples for each tag to external files, or extract them from the
.md
files at build time. - Use JSDoc to create a doclet for each code sample (optional: both with and without the tag). We might want to filter out some properties that add more noise than signal.
- Allow users to toggle between the code sample and the generated doclet (optional: highlight any changes or additions, but not deletions, that occur when the tag is added).
Or we could just build the doclets in the browser, juuuuuuuuust as soon as I finish converting JSDoc to a standalone library. 😬😬😬😬
Splitting this out from #68 because it's a large, and mostly separate, chunk of work.