[DOCS] Suggestion for the tables in documentation

Поиск
Список
Период
Сортировка
От fndevos@gmail.com
Тема [DOCS] Suggestion for the tables in documentation
Дата
Msg-id 20161208123155.1402.27288@wrigleys.postgresql.org
обсуждение исходный текст
Список pgsql-docs
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/functions-string.html
Description:

Hello,

The documentation contains a lot of tables with long function names that do
not wrap. This leads to a lot of strings breaking out of table cells.

There are ways to reformat these tables, for example, by turning 3+ column
tables into a series of 2 column tables whereby the original columns are
turned into rows.

For example:

Function | Return Type | Description | Example | Result
(with rows of overlapping data below that in PDF and very wide screens with
horizontal scrollbars in HTML)

would become

Function    | ...
Return Type | ...
Description | ...
Example     | ...
Result      | ...

(empty line followed by next row as a table)

This could surely be automated. The documentation would be so much easier to
use.

Just a suggestion.

Best regards,
Frederik De Vos


В списке pgsql-docs по дате отправления:

Предыдущее
От: 62mkv@mail.ru
Дата:
Сообщение: WANTED: more details on "pg_databases" and/or "deleting template1 database"
Следующее
От: vodevsh@gmail.com
Дата:
Сообщение: [DOCS] jsonb_each_text(jsonb) returns value::jsonb, not text