Release notes have a launcher - maybe we should remove that
Eduardo Mayorga Téllez
mayorga at fedoraproject.org
Thu Sep 18 03:53:29 UTC 2014
El 05/09/2014 8:52 am, Petr Kovar escribió:
> On Fri, 5 Sep 2014 07:21:41 -0400 (EDT)
> Bastien Nocera <bnocera at redhat.com> wrote:
>
>>
>>
>> ----- Original Message -----
>> <snip>
>> > What really got my interest was an idea to implement a new GNOME Shell
>> > search provider (https://bugzilla.gnome.org/show_bug.cgi?id=690058) that
>> > would integrate with Tracker to index locally installed docs (with
>> > the search possibly restricted to /usr/share/help/). Similarly to already
>> > indexed user documents in ~/Documents or personal contacts, users could
>> > then search for locally installed documentation, including the Release
>> > Notes, from within the Shell's Activities overview. This would allow for a
>> > far better (as in systematic) approach to finding files on the user's
>> > desktop, with a neat categorization in the Shell's search results as an
>> > added bonus.
>>
>> Search providers are all backed by applications. What's the
>> application
>> to read the docs in /usr/share/help? What would be in there other than
>> the
>> release notes?
>
> 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
>
> The right thing to do would probably be to move Release Notes
> from /usr/share/doc/ to /usr/share/help/. Indexing /usr/share/help/
> would
> get users easy access to both downstream (Release Notes) as well as
> upstream
> documentation (GNOME Help, application help, GNOME System Admin Guide,
> etc.).
>
>> It would probably be better to have those docs be converted to
>> something Yelp
>> can read and integrated in the Help, at least for GNOME and for
>> Workstation.
>
> Yes, we could do integration in the GNOME Help. Few things would have
> to
> be figured out, though:
And how do we address this for the spins? A PDF file in ~/Documents
would be enough, including evince in the media (not sure about KDE-based
spins).
Eduardo
--
http://about.me/mayorgatellez
More information about the docs
mailing list