[!!] Consider adding contents list (TOC of h2s) to country pages

[shawna-slh]

use case: user goes to https://www.w3.org/WAI/policies/united-states/

• cannot easily tell how many listings are on the page, nor get to a specific one.
• would increase usability and accessibility if could see list of all, and be able to easily jump to specific ones.

let me know if you want more use case, rationale, or other perspectives -- or if there are reasons not to add the TOC

thanks

[yatil]

ok for me

waiting on approval/feedback on #285 for implementation & publication

[bakkenb]

+1 to TOC

How would this be handled? TOC on every country page even if only one record available? Or only added to countries that have states, provinces, etc.?

Obviously it would be helpful in the example pointed to of the United States even though that is not the "state specific" page but the country page in general. I think TOC is useful in all locations.

[yatil]

We could say have a TOC when:

• at least three policies are available OR
• when there’s at least one policy and there is states data

(This raises the question of needing an inner-state TOC.)

Another idea would be to use expand/collapse instead of the boxes, but that would be quite some redesign (= what do we want them to see immediately, what after the disclosure opens…)

[bakkenb]

+1 to @yatil two bullet ideas above
-1 to expand/collapse

[shawna-slh]

I also thought about both options. (great minds think alike :-)

Agree not to do expand/collapse, especially because "that would be quite some redesign".

I was going to suggest that the TOC is only visible if there is more than one listing... but then I thought about the fact that even when there is only one, you still cannot tell that without scrolling. So I [mildly] think we should just always have a TOC. (Also a bit simpler coding. :-)

[bakkenb]

TOC always there brings consistency too.

[yatil]

OK.

[iadawn]

@shawna-slh Pulled together how this might look

• United States with TOC - multiple entry and states
• Argentina with TOC - one entry, no states
• Germany with TOC - multiple entires, states but no state information

Including TOC as a box at the top meant that the 'boxed' approach to presenting each policy started to look problematic. I have removed that to avoid the page looking too cluttered.

[shawna-slh]

I think having each policy in a box is much better usability. And follows the design pattern of course list and other such listings.

If too boxy, I think removing the Page Contents box probably better.

And, I don't think it's a big deal either way, and I'm OK removing the boxes if you and others (e.g., @brianelton ) prefer.

[iadawn]

Having all the boxes is extremely boxy. I would disagree that removing the Page Contents box is better. That is a consistent pattern across the entire site, doing something different here would be much more jarring. Having a different approach from Course List would be less problematic since jumping between course list and policies is less likely.

Note that the presentation of state information is not boxed at all. This is currently minor as there are few instances of this.

I have mocked up a sample page with all the boxes: United States with TOC and boxes

[brianelton]

Any other page in the WAI site that has a summary/page contents box at the top does not have the rest of the content in boxes, so I think removing the boxes falls in line. I vote for including the page contents in a box and having the rest of the content without a box.