[bug?] Is the format of tables in the documentation broken in PG 13?

Started by tsunakawa.takay@fujitsu.comover 5 years ago4 messages
#1tsunakawa.takay@fujitsu.com
tsunakawa.takay@fujitsu.com

Hello,

The tables for pg_stat_ views in the following page, starting from Table 27.3, have only one column in PG 13. They had 3 columns in PG 12 and earlier.

https://www.postgresql.org/docs/13/monitoring-stats.html

Is this intentional? It has become a bit unfriendly to read for me, a visually impaired user who uses screen reader software.

The tables for functions in Chapter 9 are similar.

Regards
Takayuki Tsunakawa

#2Daniel Gustafsson
daniel@yesql.se
In reply to: tsunakawa.takay@fujitsu.com (#1)
Re: [bug?] Is the format of tables in the documentation broken in PG 13?

On 15 Jun 2020, at 09:49, tsunakawa.takay@fujitsu.com wrote:

Is this intentional?

Yes, this was a deliberate change made to be able to fit more expansive
descriptions of columns etc.

It has become a bit unfriendly to read for me, a visually impaired user who uses screen reader software.

That's less good. The W3C Web Accessibility Initiative has guidance for multi-
level header tables which might be useful here.

https://www.w3.org/WAI/tutorials/tables/multi-level/

Maybe if we use the id and headers attributes we can give screen readers enough
clues to make sense of the information?

cheers ./daniel

#3tsunakawa.takay@fujitsu.com
tsunakawa.takay@fujitsu.com
In reply to: Daniel Gustafsson (#2)
RE: [bug?] Is the format of tables in the documentation broken in PG 13?

From: Daniel Gustafsson <daniel@yesql.se>

Yes, this was a deliberate change made to be able to fit more expansive
descriptions of columns etc.

Thanks for your quick response and information. I'm relieved to know that it was not broken.

That's less good. The W3C Web Accessibility Initiative has guidance for
multi-
level header tables which might be useful here.

https://www.w3.org/WAI/tutorials/tables/multi-level/

Maybe if we use the id and headers attributes we can give screen readers
enough
clues to make sense of the information?

Hm, I think I'll look into this.

Regards
Takayuki Tsunakawa

#4Tom Lane
tgl@sss.pgh.pa.us
In reply to: tsunakawa.takay@fujitsu.com (#3)
Re: [bug?] Is the format of tables in the documentation broken in PG 13?

"tsunakawa.takay@fujitsu.com" <tsunakawa.takay@fujitsu.com> writes:

From: Daniel Gustafsson <daniel@yesql.se>

That's less good. The W3C Web Accessibility Initiative has guidance for
multi-level header tables which might be useful here.
https://www.w3.org/WAI/tutorials/tables/multi-level/
Maybe if we use the id and headers attributes we can give screen readers
enough clues to make sense of the information?

Hm, I think I'll look into this.

Please do. I looked at the referenced link a bit, but it wasn't clear
to me that they suggested anything useful to do :-(.

It'd probably be best to discuss this on the pgsql-docs list.

regards, tom lane