These are chat archives for ramda/ramda

9th
Apr 2019
1point7point4
@1point7point4
Apr 09 08:08
How does Ramda support custom tags like @sig? I looked through the dev dependencies and don't see anything documentation-generation-related.
Also, Ramda seems to be a dev-dependency of itself? 🤔
1point7point4
@1point7point4
Apr 09 08:31
Wait, I think I might be on to something
Figured out that ramda's documentation page is found here on GitHub, still trying to figure out where it's actually generated.
1point7point4
@1point7point4
Apr 09 08:37
It seems like the parsed data goes to this handlebars file before getting converted to a normal HTML document.
Any help would be greatly appreciated, I haven't really poked around into stuff like this before
1point7point4
@1point7point4
Apr 09 08:48
This bit of JS seems to provide the data for the handlebars file to use. Part of it goes const version = require('./package.json').devDependencies.ramda, not sure why someone would write that instead of just require('ramda') but I only have a basic understanding of dev dependencies.
1point7point4
@1point7point4
Apr 09 17:10
Wierdly enough, it seems like the documentation is parsed by Ramda itself, then the parsed data is manipulated into human-readable text by the previous two links
🤯
Also my earlier assumption that Ramda itself didn't have anything documentation generation related was wrong, Ramda has dox (a tool for parsing JSDOC stuff) as a dev dependency.