On 2020-02-09 at 13:14:42, paul@xxxxxxxxxxxxxxxxx wrote: > Brian, > > Thanks for considering this. I've not tried MANPATH but will take a look - my employers use both Linux and Windows so this would only address half the issue but I also understand your comments on "one config to rule them all" and the HTML/MAN issue. > > I've used ASCIIDOCTOR already to create config but I feel it would be nice if that could be rolled up into some sort of bundle but it users don't want Ruby then yes, it's not going to work for them. My personal take is that anyone wanting docs for their custom applications should create them like core Git does - and with Docker and similar it's easy to isolate an environment so perhaps a Docker image might be the way to go. I don't see a problem with us shipping the stylesheets and tooling we use for our conversions as something people can use, and then if they want to install AsciiDoc or Asciidoctor, they can use the same scripts. That wouldn't be that hard to do. Personally, though, I find that I don't benefit from them much when I write documentation, and so I don't use them. Other people may feel differently, though. -- brian m. carlson: Houston, Texas, US OpenPGP: https://keybase.io/bk2204
Attachment:
signature.asc
Description: PGP signature
