#1959 Shift fedora-release-notes to PDF
Closed: Fixed 5 years ago Opened 5 years ago by bex.

What is the opinion on shifting the fedora-release-notes package to use a pdf instead of HTML? This would allow us to eliminate some dependencies on external javascript that @adamwill pointed out.

This is something that we believe we can reasonably do with the new docs pipeline. (CC: @asamalik )

What is the general opinion on this?
Do we need to include the asciidoc sources?
Should we consider package updates after release with any release note additions?


Why do we even need this package?

Why do we even need this package?

My understanding was that it is desired mostly for archival purposes. When we wanted to replace it with a static page that sent people the website, this was the feedback we got back.

My recollection is that this package was created (and until recently required as part of release critera) in order to have local copies of the documentation for off-line users, ie, users who got a physical media and installed and didn't want to keep their modem connected all the time taking up the phone line. ;)

In other words, I think it's a pretty useless historical vestige now.

https://fedoraproject.org/wiki/Fedora_29_Final_Release_Criteria#Release_notes

I'd be fine for the docs folks to do whatever they think is right about this package.

Please, can we do the sane thing and kill it as a package? This is madness at this point.

Then docs can produce whatever format they want, in as many copies as they want, in as many locations as they want.

Yeah, I think there is not reason to not let the docs authors do whatever they think is reasonable, including retiring the package. I assume almost nobody uses the static version of the notes anyway.

If this package is now no longer release blocking and can be retired at the discretion of the docs group, I am happy to take it to them for consideration. I'll follow this ticket for confirmation of the decision by FESCo.

CC: @pbokoc @asamalik

For formal FESCo vote:

Proposal: The fedora-release-notes package is no longer release-blocking for any media and will be dropped from the distribution as of Fedora 29.

I vote +1

+1 for "The fedora-release-notes package is no longer release-blocking for any media". If the docs team wants to retire the package, I am also +1 for "and will be dropped from the distribution as of Fedora 29." but I would also allow anyone to maintain the package if they want.

+1, and I also like @till's addition.

(That's +6, so approved.)

Well, it's approved already but I might as well note that as a representative of the docs team I support dropping this requirement. It's been a problem for us in the past and the release notes are available online.

Metadata Update from @maxamillion:
- Issue close_status updated to: Fixed
- Issue status updated to: Closed (was: Open)

5 years ago

Login to comment on this ticket.

Metadata