<p dir="ltr"><br>
On Sep 19, 2014 6:48 AM, "Petr Kovar" <<a href="mailto:pkovar@redhat.com">pkovar@redhat.com</a>> wrote:<br>
><br>
> On Wed, 17 Sep 2014 21:53:29 -0600<br>
> Eduardo Mayorga Téllez <<a href="mailto:mayorga@fedoraproject.org">mayorga@fedoraproject.org</a>> wrote:<br>
><br>
> > El 05/09/2014 8:52 am, Petr Kovar escribió:<br>
> > > On Fri, 5 Sep 2014 07:21:41 -0400 (EDT)<br>
> > > Bastien Nocera <<a href="mailto:bnocera@redhat.com">bnocera@redhat.com</a>> wrote:<br>
> > ><br>
> > >><br>
> > >><br>
> > >> ----- Original Message -----<br>
> > >> <snip><br>
> > >> > What really got my interest was an idea to implement a new GNOME Shell<br>
> > >> > search provider (<a href="https://bugzilla.gnome.org/show_bug.cgi?id=690058">https://bugzilla.gnome.org/show_bug.cgi?id=690058</a>) that<br>
> > >> > would integrate with Tracker to index locally installed docs (with<br>
> > >> > the search possibly restricted to /usr/share/help/). Similarly to already<br>
> > >> > indexed user documents in ~/Documents or personal contacts, users could<br>
> > >> > then search for locally installed documentation, including the Release<br>
> > >> > Notes, from within the Shell's Activities overview. This would allow for a<br>
> > >> > far better (as in systematic) approach to finding files on the user's<br>
> > >> > desktop, with a neat categorization in the Shell's search results as an<br>
> > >> > added bonus.<br>
> > >><br>
> > >> Search providers are all backed by applications. What's the<br>
> > >> application<br>
> > >> to read the docs in /usr/share/help? What would be in there other than<br>
> > >> the<br>
> > >> release notes?<br>
> > ><br>
> > > It could be gnome-documents as Matthias proposed if we choose to ship<br>
> > > PDF<br>
> > > instead of a bunch of HTML pages.<br>
> > ><br>
> > > It could be yelp as it supports transforming DocBook/Mallard XML as<br>
> > > well as<br>
> > > viewing HTML pages. I just tested it and yelp works quite well:<br>
> > ><br>
> > > $ yelp /usr/share/doc/fedora-release-notes/index.html<br>
> > ><br>
> > > The right thing to do would probably be to move Release Notes<br>
> > > from /usr/share/doc/ to /usr/share/help/. Indexing /usr/share/help/<br>
> > > would<br>
> > > get users easy access to both downstream (Release Notes) as well as<br>
> > > upstream<br>
> > > documentation (GNOME Help, application help, GNOME System Admin Guide,<br>
> > > etc.).<br>
> > ><br>
> > >> It would probably be better to have those docs be converted to<br>
> > >> something Yelp<br>
> > >> can read and integrated in the Help, at least for GNOME and for<br>
> > >> Workstation.<br>
> > ><br>
> > > Yes, we could do integration in the GNOME Help. Few things would have<br>
> > > to<br>
> > > be figured out, though:<br>
> ><br>
> > And how do we address this for the spins? A PDF file in ~/Documents<br>
> > would be enough, including evince in the media (not sure about KDE-based<br>
> > spins).<br>
><br>
> Seems like the easiest fix for those spins having a traditional desktop menu<br>
> with a Documentation submenu would be to use OnlyShowIn in the launcher<br>
> desktop file. Fedora Workstation could also go with NotShowIn.<br>
><br>
> A PDF file in ~/Documents is another possibility.<br>
><br>
> Cheers,<br>
> pk<br>
><br>
> --<br>
> Petr Kovar<br></p>
<p dir="ltr">This is what we have now, essentially; there's a NotShowIn=GNOME desktop file that is otherwise the same as it has been for the last few releases.</p>
<p dir="ltr">There's also an OnlyShowIn=GNOME desktop file that launches the book in epiphany for more native presentation, available to WS users that manually install fedora-release-notes.</p>
<p dir="ltr">--Pete</p>