On Thu, Sep 13, 2018 at 11:01 AM Julian Foad <julianfoad_at_apache.org> wrote:
>
> It seems to me rather poor that readers of our CHANGES file have to manually follow references to revision numbers and issue numbers. Examples:
> [[[
> - Server-side bugfixes:
> * svnadmin dump shouldn't canonicalize svn:date (issue #4767)
> * 'svnadmin verify --keep-going --quiet' shows an error summary (r1837790)
> ]]]
>
> I have shortcuts defined in my browser for going to a revision or an issue by number, but must users don't, so I feel it is pretty unfriendly to them.
>
> As the file format is pretty regular, would anyone care to contemplate post-processing it into HTML with the revision numbers and issue numbers as hyperlinks?
>
> I would suggest keeping the current file format as the original and posting the processed version somewhere. A static link in the original (text file) could point to the canonical URL of the HTML version. Just a trunk version would be sufficient initially, updated at least at every release and preferably more often.
>
I suggest to create a wiki variant (with hyperlinks) on our Confluence
wiki, rather than just a HTML-ized version. That should be doable to
automate, to go over the plain text version and replace #4767 into
[#4767|https://.../SVN-4767] etc.
(sorry, I'm not volunteering right now, it's just a suggestion -- I
might find some time in a couple of weeks, but not immediately ... so
if anyone else feels inclined ...)
--
Johan
Received on 2018-09-13 11:18:43 CEST