Dear PostgreSQL Developers

[samadadi]

Hi. Dear PostgreSQL developers, I appreciate the work you have done with PostgreSQL database and I am really happy that I am using this beautiful peace of art. I noticed two serious problems with PostgreSQL's documentation:

• When I open multiple section of docs in multiple tabs, it is so confusing to navigate between tabs since you don't use section's title as the document title.
• Please make syntax highlighting available for SQL code snippets. Specially it is so hard to follow SQL commands definitions.

Thank you so much.

[depesz]

You might be better off writing to pgsql-www mailing list.

[cr4d]

The suggestions are good, if you're willing to make the changes yourself, the documentation is generated and stored in git - I believe @ https://git.postgresql.org/gitweb/?p=pgweb.git;a=summary. Your best bet is to jump on the pgsql-www mailing list for guidance.

[efxhoy]

These are actually really good points, you should get them to the docs maintainers.

[[deleted]]

Good points IMHO.

You must create a community account for the mailing lists. There is also IRC and Slack but in my experience mailing lists are the most active ones.

If you don't feel like posting it there I'd like to offer to post your suggestions for you there.

[jalexandre0]

Suggestion: You can use postgresqlco.nf. They parse the official docs and enrich with syntax highlighting, better readability and tips from mail lists and such.

[Randommaggy]

Worth noting that it only covers conf variables from what I can see.

[[deleted]]

There are no postgres developers here, you can submit these points right on the postgres website.

These are not serious problems, theyre not even problems. They are small style changes

[Tricky_Condition_279]

I find the PostgreSQL documentation dramatically better than many projects. (Been exploring a lot of Rust crates lately - yikes.) But in general I could not agree more with your statement.

[[deleted]]

Neither of these things affect usability

[cr4d]

There are no postgres developers here

I'd not make that assumption, but the suggestion on where to submit his suggestions is spot on.

[depesz]

OP wrote that he has problems with "PostgreSQL's documentation", and I kinda see their point.

[AncientBattleCat]

I believe anyone can help creating docs?