Release notes have a launcher - maybe we should remove that

Petr Kovar pkovar at redhat.com
Mon Sep 8 17:50:49 UTC 2014


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


More information about the docs mailing list