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 768849 - Update documentation to reference both GDA and GOM as Data Storage APIs
Update documentation to reference both GDA and GOM as Data Storage APIs
Status: RESOLVED FIXED
Product: gnome-devel-docs
Classification: Applications
Component: programming-guidelines
3.20.x
Other Linux
: Normal normal
: ---
Assigned To: GNOME Devel docs: Programming Guidelines maintainer(s)
gnome-devel-docs maintainers
Depends on:
Blocks:
 
 
Reported: 2016-07-15 15:01 UTC by Isaque Galdino
Modified: 2016-11-23 10:40 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
programming-guidelines: Compare GOM and GVDB to GDA (1.26 KB, patch)
2016-08-02 17:41 UTC, Philip Withnall
committed Details | Review

Description Isaque Galdino 2016-07-15 15:01:08 UTC
On https://developer.gnome.org/programming-guidelines/unstable/databases.html.en page it only refers to GOM and GVDB APIs, but it doesn't talk about GDA or how to choose it over GOM.

On the other hand, in https://developer.gnome.org/references under Data Storage section we have only GDA and libglom, while GOM is under Others section. GVDB is not even mentioned in this page.
Comment 1 Philip Withnall 2016-08-02 17:41:15 UTC
Created attachment 332591 [details] [review]
programming-guidelines: Compare GOM and GVDB to GDA

We don’t recommend use of GDA for storing user data, unless the whole
point of the program is to access databases.
Comment 2 Philip Withnall 2016-08-02 17:49:22 UTC
Also pushed 6574d7ecaf8bf258496e2ca49d66d8ca2e647a94 to library-web to move libgom to the Data Storage section.
Comment 3 Philip Withnall 2016-11-21 12:08:27 UTC
Dave, any chance of a review please? :-)
Comment 4 David King 2016-11-22 12:37:32 UTC
Review of attachment 332591 [details] [review]:

::: programming-guidelines/C/databases.page
@@ +88,3 @@
+      targeted at abstracting access to various types of relational database,
+      for use in a database utility program or office program, for example. It
+      is not suitable for storing user data.

"user data" is a bit vague. Maybe something like "user settings" would be better, with a link to GSettings?
Comment 5 Philip Withnall 2016-11-23 10:39:58 UTC
Pushed with that fix, thanks.

Attachment 332591 [details] pushed as 74ab631 - programming-guidelines: Compare GOM and GVDB to GDA