On Thu, Sep 13, 2018 at 11:01 AM Julian Foad <julianf...@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

Reply via email to