[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#877367: Bug #877367: www.debian.org: Please consider adding redirects for old Policy chapters/appendices

control: block -1 by 876075

Hello Laura,

On Wed, Jan 03 2018, Laura Arjona Reina wrote:

> Hello
> DSA team kindly applied the patch for Apache rewrite rules, and I've
> checked that it works as intended, at least with the examples provided
> in this bug report, plus the ones that Rebecca linked in the codesearch
> query.
> One of the rules is to redirect:
> www.debian.org/doc/debian-policy/ch-whatever.html#oldsection ->
> www.debian.org/doc/debian-policy/#document-ch-whatever
> and maybe it's better to redirect in this way:
> www.debian.org/doc/debian-policy/ch-whatever.html#oldsection ->
> www.debian.org/doc/debian-policy/#oldsection
> At least I've checked with the links present in developers-reference
> (the ones that pointed Rebecca) and it works, since the "oldsection"
> anchors are in the form "s-section" and the sections inside chapters are
> named the same.
> But I'd like somebody from the Policy team to confirm (since they know
> better the schema used for naming anchors).
> Sean, if you prefer that we redirect to the chapter as we are doing now,
> feel free to close this bug. If you can confirm that all the
> ch-whatever.html#oldsection can be safely redirected to #oldsection
> (suppressing the substring of chapter), I would write a new patch for
> this rule in the Apache config.

Thank you for reporting back.

In #876075, we are considering dropping singlehtml output from the
debian-policy package.  There are numerous other bugs -- such as all
footnote hyperlinks being broken -- and upstream sphinx seems to focus
their efforts on the multi-page output, which is much better quality.

I think we need to resolve that discussion before we can respond to your
request for feedback in your message quoted above.  Either way we are
going to need redirects, but it's not yet clear which.

I hope that you do not feel that your time has been wasted helping us
improve the singlehtml publishing, only for us now to be considering
switching back to multi-page :(  We really wanted to make it work, but
the quality of the output just isn't good enough.

Sean Whitton

Attachment: signature.asc
Description: PGP signature

Reply to: