Thread: [bug?] Is the format of tables in the documentation broken in PG 13?
[bug?] Is the format of tables in the documentation broken in PG 13?
From
"tsunakawa.takay@fujitsu.com"
Date:
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 3columns 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
Re: [bug?] Is the format of tables in the documentation broken in PG13?
From
Daniel Gustafsson
Date:
> 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
RE: [bug?] Is the format of tables in the documentation broken in PG13?
From
"tsunakawa.takay@fujitsu.com"
Date:
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
"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