Database tables documentation

2024-11-02 13:49:44

Hubzilla Support Forum

adminsforum@hubzilla.org

od wrote the following post Sat, 02 Nov 2024 13:49:47 +0100

Database tables documentation

Is there documentation anywhere to describe the purpose of each table in the hubzilla postgresql database?

- - -

2024-11-03 13:14:36

Der Pepe (Hubzilla) ⁂ ⚝

pepecyb@hub.hubzilla.hu

I think that these explanations (on .htconfig.php and the database schema) already belong here and are sufficient.

Installing a hub manually is not necessarily something that should be recommended to an inexperienced user. However, if you have the basics, you will be able to follow the instructions and will be told what to do if the automatic setup process fails. How to edit a file (htconfig.php) and save it under a new name does not need to be explained. And the experienced admin should know how to import a database schema (or know where to look this up... namely in the documentation of the database they are using).

In my opinion, there is no harm in explaining simple steps in the user documentation (I even recommend it), but certain prerequisites should be assumed for the admin documentation... or at least the knowledge of where to look for information.

2024-11-03 19:55:19

od@zotum.net

Good quality documentation, means more users and programmers. There are many examples: apache, debian, arch.
If extant hubzilla programmers continue to be unable to improve documentation, the quality and number of contributors will continue to be very low after all these years.

2024-11-03 23:57:31

Scott M. Stolz

scott@loves.tech

We have several people working on documentation.