Hi JJ, Wouldn't it be useful if Vadim commented on an appropriate GH issue? If so, which would that be? https://github.com/perl6/user-experience/issues/35 ? https://github.com/perl6/Pod-To-HTML/issues/55 ? https://github.com/perl6/doc/issues/167 ? Somewhere else?
-- raiph On Mon, Jan 14, 2019 at 1:07 AM Vadim Belman <vr...@lflat.org> wrote: > > > >> Not to mention different module versions, on top of what you wrote. >> >> Ok, I would think about it. One thing comes to my mind: in Synopsis 26 ( >> https://design.perl6.org/S26.html) there is a mention of =config >> directive. It can be used to define where the links must point to. >> Something like: >> >> =config github:/user/module/tree/master/docs >> > > I'm not sure =config is implemented right now, my money is on NYI. And > still there's the problem that pod6 or pod-embedded-in-Perl6 is not > rendered anywhere, I think, not even in modules.perl6.org. Dumping > someone in a page full of Pod6 source code is LTA. I mean, you can as well > create a link to actual, rendered documents that you have generated > somewhere. > > > I know it is not implemented, but it might be at some point. So, perhaps > it makes sense to think out a possible solution? > > As to the format issue – I for myself solved it for now by generating both > .md and .html and writing a script which patches source PODs to point links > at the right version tag on github. Perhaps, this will be the best approach > for a couple of years to come. > > Best regards, > Vadim Belman > >