Repository navigation
Conversation
1ba2e4d to
0b418c8
Compare
0b418c8 to
4f4c933
Compare
headius
left a comment
There was a problem hiding this comment.
Nice! Is the utility code here sourced from somewhere else? You mention this is similar to what CRuby does. I'm wondering if a common gem could be pulled out, if one hasn't been already.
I'm not sure what the dev process would be. Do we generate the man at release time (and always in CI to keep it working) or do we generate periodically and keep the most recent copy in the repository?
|
With "Similar to cruby" I ment that the manual page header is kind of similar now. For me it seems that there is not too much code shared for a gem. Code that converts data to man page friendly is small and easy and same goes for the erb. About dev process I think @jcharaoui can give feedback that if this way that man page is in release only is ok? |
|
There's a lot of moving parts in there, I'm not sure it's ideal maintenance-wise? Have we considered a solution that uses something like ronn to convert a plain Markdown template to a manpage. |
|
How would we generate Markdown template? What would render the template to final markdown (maybe you didn't mean to say template but just Markdown file)? |
One suggestion how to add kind of similar man page as cruby uses. Fixes #9612.