[relnotes] [Bug 501805] New: Ugly URLS that may change on rebuild due to DocBook section ID attribute not set
bugzilla at redhat.com
bugzilla at redhat.com
Wed May 20 19:07:07 UTC 2009
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: Ugly URLS that may change on rebuild due to DocBook section ID attribute not set
https://bugzilla.redhat.com/show_bug.cgi?id=501805
Summary: Ugly URLS that may change on rebuild due to DocBook
section ID attribute not set
Product: Fedora Documentation
Version: devel
Platform: All
URL: http://docs.fedoraproject.org/release-notes/f11preview
/en-US/index.html
OS/Version: Linux
Status: NEW
Severity: urgent
Priority: urgent
Component: release-notes
AssignedTo: relnotes at fedoraproject.org
ReportedBy: kwade at redhat.com
QAContact: kwade at redhat.com
CC: wb8rcr at arrl.net
Blocks: 151189
Classification: Fedora
Target Release: ---
It appears that none of the section ID attributes were set for the Fedora 11
release notes, so URLs are ugly ...
http://docs.fedoraproject.org/release-notes/f11preview/en-US/index.html#id2781534
... instead of pretty and welcoming ...
http://docs.fedoraproject.org/release-notes/f10/en_US/index.html#Welcome_to_Fedora_10
In addition, it is possible that the generated ID attributes are different
every time the release notes are built from DocBook source. This means that
when the release notes are updated with bug fixes, it may break every single
URL link inward. That is not good. (Not sure if this behavior is still the
same in the DocBook toolchain.)
As a person who has done the manual ID attribute creation since forever, I know
what a PITA it is. There are ways to work this out with improvements to the
toolchain (either how the DocbBook comes from the wiki or how Publican handles
it by auto-generating ID attributes from the contents of the <title> block).
In the meanwhile, I can only see manual ID attributes as the way to go.
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
More information about the Fedora-relnotes-content
mailing list