On Fri, 05 Sep 2014 15:12:04 -0400
Matthias Clasen <mclasen(a)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