After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 696574 - Better book list order in the sidebar
Better book list order in the sidebar
Status: RESOLVED WONTFIX
Product: devhelp
Classification: Applications
Component: General
unspecified
Other Linux
: Normal enhancement
: ---
Assigned To: devhelp-maint
devhelp-maint
Depends on:
Blocks:
 
 
Reported: 2013-03-25 17:25 UTC by William Jon McCann
Modified: 2017-06-29 11:10 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description William Jon McCann 2013-03-25 17:25:36 UTC
Currently the list of books is totally incoherent. It is an alphabetical list of random and unrelated stuff. This is hard to use and confusing.

I think we should have at least two sections in the sidebar.

---------------------------------------
GNOME Platform libraries
(top down from the user point of view)
------------------------------
Everything else
(alphabetical)
---------------------------------------
Comment 1 Aleksander Morgado 2013-05-15 10:46:03 UTC
We also thought of doing this during the DX hackfest, but it didn't go anywhere because IMO it is very hard to come with a ordered list of GNOME platform libraries... So suggestions on the expected list are more than welcome.
Comment 2 Aleksander Morgado 2013-08-06 10:13:18 UTC
Adding Federico in CC, in case he wants to comment.
Comment 3 Federico Mena Quintero 2013-08-06 10:33:01 UTC
We already have a reasonable organization of the platform libraries in the Overview of the Gnome Platform.  This is from gnome-devel-docs/new-platform-overview/tech.page:

User interface and display
GTK+ — Widget toolkit for graphical interfaces
GDK — Low-level abstraction for the windowing system
Cairo — 2D, vector-based drawing for high-quality graphics
Pango — International text rendering with full Unicode support
Clutter — Animations and scene graph
WebKit — HTML5 web page rendering
ATK — Accessibility toolkit to implement support for screen readers and other tools

Storage of the user's data
Evolution Data Server — Desktop-wide addressbook for contacts and calendar
GSettings — Configuration storage for application preferences
Secret — Secure storage for passwords and other data
GNOME Data Access — Unified access to relational databases
Tracker — Storage and retrieval for document metadata

File access
GIO Files — File and URI handling, asynchronous file operations, volume handling

Networking
GIO Networking — Networking and sockets API with streams
Soup — Asynchronous HTTP library with cookies, SSL, and XML-RPC
Avahi — Zeroconf service discovery on local networks
GUPnP — Wireless, peer-to-peer, plug-and-play RPC
NetworkManager — Manage network connections and monitor online/offline status

Application support
Help — Topic-oriented online help system
Enchant — Real-time spell checking for text widgets
PackageKit — Software installation and management
Notify — Interactive notifications in the desktop's message tray
Poppler — PDF rendering
Telepathy — Unified instant-messaging and communications service
Folks — Aggregate contacts from multiple local and online sources

Multimedia
Canberra — Simple audio API for notifications and events
GStreamer — Playing, mixing, and manipulating sound and video
PulseAudio — Low-level audio API

Inter-process communication
D-Bus — Inter-process communication bus to provide APIs to other processes
Polkit — Access control for system-level services provided through D-Bus

Geographical
Champlain — Map rendering
Geoclue2 — Geolocation - finding the user's geographical location
Geocode-glib — Geocoding and reverse geocoding - conversion of street addresses to/from geographical coordinates

Foundational C utilities and object system
GLib — Data structures and utilities for C programs
GObject — C-based object and type system with signals and slots

Feel free to use it!
Comment 4 Sébastien Wilmet 2015-05-18 11:32:09 UTC
Another idea is to have a start page.
Comment 5 Sébastien Wilmet 2017-06-29 11:10:18 UTC
(In reply to Sébastien Wilmet from comment #4)
> Another idea is to have a start page.

Filed as bug #784331.

Devhelp can be used in theory for totally different development platforms, as long as Devhelp index files are written (and as long as the docs are available in HTML format).

I would much prefer to keep the book list in alphabetical order.

So in short I think that an optional start page specific for GTK+/GNOME is a better idea. This would work better if the latest docs can be downloaded, see bug #761284.