Bug 1296948 - Many docs are missing after installing Devhelp
Summary: Many docs are missing after installing Devhelp
Keywords:
Status: CLOSED UPSTREAM
Alias: None
Product: Fedora
Classification: Fedora
Component: devhelp
Version: 23
Hardware: x86_64
OS: Linux
unspecified
unspecified
Target Milestone: ---
Assignee: Matthew Barnes
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-01-08 14:23 UTC by Jonathan Kang
Modified: 2016-01-12 09:38 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-01-11 11:51:29 UTC
Type: Bug


Attachments (Terms of Use)
Add-ons for Firefox in Gnome-Software (161.88 KB, image/png)
2016-01-08 14:23 UTC, Jonathan Kang
no flags Details

Description Jonathan Kang 2016-01-08 14:23:32 UTC
Created attachment 1112880 [details]
Add-ons for Firefox in Gnome-Software

Description of problem:
I did a fresh installation of Fedora 23, and installed Devhelp 3.18.1 using "dnf install devhelp". Once I opened Devhelp the first time, I found that many APIs are missing. For example, APIs about Gtk+, GLib, etc. Later on, I asked for David's found that I should install some packages like gtk3-devel-docs and gtk-doc to get those APIs available in Devhelp.

Version-Release number of selected component (if applicable):
3.18.1

How reproducible:
Every time

Steps to Reproduce:
1.Install Fedora 23 x86_64
2.Install Devhelp 3.18.1

Actual results:
A lot of APIs are missing, such as APIs about Gtk+ and Glib.

Expected results:
All available APIs should be available, or at least prompt users to install them if needed.

Additional info:
So I'm thinking a way to improve this(some ideas from David King).

I think Devhelp should recommend users those packages that may be needed by itself. For example, in Gnome-Software, add a "Add-ons" section to recommend those docs packages(as shown in the attached picture). If users are installing Devhelp using command line, maybe devhelp can recommend those documentation packages.

That way, it would be better so that some users like me will not google it or ask someone else for help. It would be a very nice improvement, in my opinion.

Comment 1 Debarshi Ray 2016-01-11 11:51:29 UTC
There is no point tracking this downstream. It is a matter of implementing a feature and for that bugs and patches on bugzilla.gnome.org are what we use.

Nice idea, though. I am looking forward to it!

Comment 2 Jonathan Kang 2016-01-12 09:38:31 UTC
I opened a bug firstly in bugzilla.gnome.org, and was told to open a bug here rather than in gnome bugzilla. And you told me it's gnome bugzilla where I should open the bug.

The previous bug opened in gnome bugzilla can be found here: https://bugzilla.gnome.org/show_bug.cgi?id=760313


Note You need to log in before you can comment on or make changes to this bug.