[request-tracker-maintainers] Expose docs via web interface?

[Andrew Ruthven]

On Sat, 2023-06-17 at 18:27 +0100, Dominic Hargreaves wrote:
> On Sun, Jun 18, 2023 at 12:13:46AM +1200, Andrew Ruthven wrote:
> > I do like the idea of using the local docs, but there are a couple of
> > problems:
> > 
> > 1. Currently they're only a Suggests. This means that we'd need to have
> > a
> > place holder page if they aren't installed saying "Say, install this".
> > 2. They're ugly, there is no CSS provided.
> 
> This is https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704773 FWIW

Okay, after a bit of tinkering this afternoon I have a proof of concept for
exposing the documentation locally within RT using a dhandler. I'm going to
ask BP if they'd be interested in including this as part of RT core. If not,
I'll make it an extension.

This isn't quite what 704733 is about, as I'm not styling the individual
pages, but I reckon it'd satisfy the intent.

> The other consideration might be whether the docs might be more up to
> date online compared to the shipped stuff. Probably not a big deal.

Yup. This could be handled by saying "Refer to this location for the most up
to date documentation".

-- 
Andrew Ruthven, Wellington, New Zealand
andrew at etc.gen.nz         |
Catalyst Cloud:           | This space intentionally left blank
 https://catalystcloud.nz |