crystal docs generates an
index.json file, which has markdown already converted to HTTP entities. It makes the docs depend on Crystal’s built-in markdown parser, which is not perfect. I wonder if it is possible to emit raw docs instead (just like in the code)?
I also noted that docs emit links (
source_link) tied to github, and it’s kinda magic for me. Does it read from
.git directory? Shouldn’t it be more abstract?
In general, I’d like to see
docs command to only gather the information of types and methods across the program and emit it in raw but structured format, which can be interpreted differently afterwards.
My use-case is building an alternative VueJS-powered API front-end.