| Summary: | Many docs are missing after installing Devhelp | ||||||
|---|---|---|---|---|---|---|---|
| Product: | [Fedora] Fedora | Reporter: | Jonathan Kang <jonathan121537> | ||||
| Component: | devhelp | Assignee: | Matthew Barnes <mbarnes> | ||||
| Status: | CLOSED UPSTREAM | QA Contact: | Fedora Extras Quality Assurance <extras-qa> | ||||
| Severity: | unspecified | Docs Contact: | |||||
| Priority: | unspecified | ||||||
| Version: | 23 | CC: | debarshir, mbarnes | ||||
| Target Milestone: | --- | ||||||
| Target Release: | --- | ||||||
| Hardware: | x86_64 | ||||||
| OS: | Linux | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2016-01-11 11:51:29 UTC | Type: | Bug | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Attachments: |
|
||||||
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! 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 |
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.