Re: #932957 Please migrate Release Notes to reStructuredText
Holger Wansing <hwansing@mailbox.org> writes:
> However, I may have some objections against the migration at all:
> as far as I know, sphinx/reStructuredText is still lacking some functionality,
> which is heavily used in the release-notes.
> That is the use of substitutions within URLs.
> In docbook speach these were entities, and you could use them in URLs like this:
>
> Please follow the instructions in the <ulink
> url="https://www.debian.org/releases/&oldreleasename;/releasenotes";>Release
> Notes for &debian; &oldrelease;</ulink> to upgrade to &debian;
> &oldrelease; first if needed.
>
> Please note the &oldreleasename; in the URL!
> I could not get this working with sphinx (if someone knows better, please
> contact me!)
No idea about sphinx, but we could we just run a simple sed script to update
i've submitted several patches to release notes, and found the use of
entities and XML more confusing than helpful (especially '&debian;' for
'Debian') - this is meant to be a document for people, and needs a
decent proof-read anyway.
Reply to: