Hello www-team,

I'd like to suggest adding redirects for the old chapters and appendices
of the Policy Manual, redirecting to the single HTML version, if
possible with anchor references.  E.g.

https://www.debian.org/doc/debian-policy/upgrading-checklist.html
    --> https://www.debian.org/doc/debian-policy/#upgrading-checklist

https://www.debian.org/doc/debian-policy/ch-opersys.html
    --> https://www.debian.org/doc/debian-policy/#the-operating-system

I've had several people suggest this, especially for the upgrading
checklist, on IRC.

This breaks the (6 according to codesearch [0]) links from Developers'
Reference to specific Policy sections.

[0]
https://codesearch.debian.net/search?q=package%3Adevelopers-reference+url-debian-policy%3Bch-

Control: tags -1 +patch

Hello
Meanwhile we resolve #877337 (trying to accomodate in the website both
single-page HTML and splitted in chapters HTML versions of
debian-policy), I've prepared a patch so the petitions to the old
addresses (splitted in chapters format) are redirected to the
corresponding sections in the single-html file.

The patch is for the Apache configuration of www.debian.org, in
particular, the file:

https://anonscm.debian.org/cgit/mirror/dsa-puppet.git/tree/modules/roles/templates/apache-www.debian.org.erb

I've checked that the names of the old chapters match with the name of
the current sections.

I've tried to take into account that both URLs of the type
www.debian.org/doc/debian-policy/ch-whatever.html and
www.debian.org/doc/debian-policy/ch-whatever.html#oldsection are
redirected to www.debian.org/doc/debian-policy/#document-ch-whatever
(not sure if I did it correctly, though).

I didn't add exact rules to match
www.debian.org/doc/debian-policy/footnotes.html#f1 to
www.debian.org/doc/debian-policy/#id1 etc because I'm not sure all the
"old" footnotes and the "new" footnotes match in content; I've just
tried to redirect to the manual page for that cases.

My regex skills are few so I've just tried to produce something looking
at the already existing RewriteRule expressions. Please review and
improve if possible.

In 2-3 days, I'll file an RT ticket with this patch (or improvements)
for DSA. If you happen to review it and improve it and want to file the
ticket yourselves, please go ahead!

Cheers

Laura Arjona Reina wrote:

Updated the patch (to the current git repo status) and submitted the RT
ticket #7028.

Cheers

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.

Cheers

control: block -1 by 876075

Hello Laura,

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.

Hello

El 03/01/18 a las 16:07, Sean Whitton escribió:

Not at all. We're currently shipping the single page version in the
website, so until that is changed, these redirects being in place are a
good thing, IMO.
Also, got more familiarized with the Apache config so next patches for
redirects will be easier :)

Cheers

Hello Laura,

I've realised that I didn't answer your request.  Let me do that now.

When we converted the docbook to markdown, we imported the section IDs
with a 's-' prefix.  So for example, #s-sd-1 correctly reaches the first
subsection of "Control files and their fields (from old Packaging
Manual)".

So, yes, ch-whatever.html#oldsection should redirect to #oldsection --
but there might be more conversion required.  For example #sD.1 becomes
#sd-1 and you might need to strip the s- prefix.

In short, it is complicated enough that I think it would be best to wait
until we've figured out if singlehtml is sticking around.

Okay.  TTBBMK you should use 302 redirects, not 301, because of the
possible change back to the multi-page format.

Hello

El 15/01/18 a las 01:57, Sean Whitton escribió:

I've sent a patch changing the 301 to 302, via RT #7058.

Cheers

Hello Laura,

We have now decided to drop singlehtml output, i.e., drop policy-1.html.
It is just too buggy and we don't want to continue including it in the
Debian archive.

Could you switch the web mirrors to use the multipage version, please?
Then I can drop the file from our releases.

If Sphinx upstream improves the singlehtml output sufficiently that we
decide to include it in our package again, I don't think we'd want to
change the web mirrors again.  So you can take this change as the final
change for as long as we use Sphinx, and put in place permanent 301
redirects.

Thank you for your patience.

Why we would not want that ?

Cheers,

Hello Bill,

Sorry, I should have said -- because we've broken links too many times
over this transition, generating work for other teams.  I want to stop
doing that!

Hello,

This is now done, thanks to Paul Wise.

This will happen on the next upload.

I am not sure which of these two bugs should remain open and with what
metadata; leaving that to the www-team.  But indeed, permanent redirects
can now be added.

Hello,

Good morning,

We have gone through your samples from a partner and Here is our  Order
List. Please do bear in mind that we are very much in  need of this
order, quote your competitive prices.

Kindly send the Order confirmation.

Your early reply will be much appreciated.

Best Regards,

Maryanah Erwin.

PT FINDORA INTERNUSA

Jln Pahlawan 66 Kec. Arjawinangun

45162 CIREBON West-Java INDONESIA

tel : +62 231 357334

fax: +62 231 357260

email: marketing@findora.com