On Fri, 05 Sep 2014 15:12:04 -0400 Matthias Clasen mclasen@redhat.com wrote:
On Fri, 2014-09-05 at 16:52 +0200, Petr Kovar wrote: \
It could be gnome-documents as Matthias proposed if we choose to ship PDF instead of a bunch of HTML pages.
It could be yelp as it supports transforming DocBook/Mallard XML as well as viewing HTML pages. I just tested it and yelp works quite well:
$ yelp /usr/share/doc/fedora-release-notes/index.html
I think all of these questions about formats and tools are a bit secondary though.
I agree that these are secondary as long as desktop users can find what they are looking for. Providing a docs search functionality would surely help with that need.
Having the release notes on the system really makes most sense if we actually make an effort to present them to the user when he would be most interested in seeing them - right after installation.
+1
The current post-install workflow already launches yelp with the gnome-getting-started guide. Maybe that page can be expanded to include the release notes in some form ?
Yes, this is something we can do. Assuming that we want to provide a link to the Release Notes from the GNOME Getting Started landing page, there are multiple ways to approach this. As I said, we could add the link upstream and use Mallard conditionals to only display the link on Fedora since the link is downstream-specific. We could also provide a downstream patch but translations would be a problem then.
GNOME Initial Setup could also get an extra button that would launch the Release Notes.
Cheers, pk