Skip to content

Conversation

@rianrietveld
Copy link
Member

@rianrietveld rianrietveld commented Nov 14, 2025

The related issue number: #218 (new design) and #221 (description to search)

Design Jeffrey Lauwers:
https://www.figma.com/design/MTMLnjkAGJvYrZjTeu5ert/WP-Accessibility-Knowledge-Base?node-id=33-1237&t=byeUhJr81gGKjPNv-0

Preview: https://wpaccessibility.org/pr-preview/pr-220.

Note:
The search on mobile is not the best experience ux-wise.
We need to discuss if the drop down on mobile is useful and if we can move the search on. mobile above the menu.

@rianrietveld rianrietveld self-assigned this Nov 14, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 14, 2025

PR Preview
🚀 View PR Preview at https://wpaccessibility.org/pr-preview/pr-220.
If you see a 404 error, please wait a few minutes and refresh the page.
2025-11-22 11:58 UTC

@rianrietveld rianrietveld linked an issue Nov 21, 2025 that may be closed by this pull request
@rianrietveld rianrietveld marked this pull request as ready for review November 22, 2025 12:05
@rianrietveld rianrietveld moved this to PRs to review in WP A11y docs Nov 22, 2025
@rianrietveld rianrietveld linked an issue Nov 22, 2025 that may be closed by this pull request
@rianrietveld rianrietveld changed the title [Draft] New design for wpaccessibility.org New design for wpaccessibility.org Nov 22, 2025
Copy link
Member

@joedolson joedolson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have some minor comments, but on the whole I think we should just merge this. From a practical standpoint, this is very hard to review - combining a refactor of the docs JS with other changes is something I wouldn't generally do, as it makes the diff much harder to parse.

There are some minor things - like I think the vertical height of the secondary nav items is too tall, and I don't fully agree with the accessible name of the primary logo with the img inside the link, but I think they can be adjusted as follow ups.

The description is in the index and shown in results, but isn't being searched; that'll probably need to be tweaked, as well.

@@ -1,23 +1,22 @@
<div class="search">
<form class="search-input-wrap" role="search" action="{{ site.baseurl }}/search/" method="get">
<search class="search">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think this has sufficient compatibility? The search element has only been supported on Safari since version 17, so older Macs & iOS devices may not get the landmark role from the element. Other browsers are on similar timelines, but Safari is unique in that devices that can't be updated to more recent OS also can't update their browsers.

<img src="{{site.baseurl}}/assets/images/logo.jpg" alt="Accessibility: Advocate Equal Access">
<a href="{{ '/' | relative_url }}" class="site-title lh-tight">
{{ site.title}}</a>
<img src="{{site.baseurl}}/assets/images/logo-wa11ypuu.png" alt="WP Accessibility logo, to homepage">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't personally like having the accessible name of the link have all this information in it. This becomes "WP Accessibility logo, to home page WP Accessibility Knowledge Base", which seems excessive to me.


.nav-list-item {
position: relative;
min-height: 48px;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this gives too much height on secondary nav items. I'd remove it and use something like padding: 4px 0;

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: PRs to review

Development

Successfully merging this pull request may close these issues.

Add description field to search results [Website] Implement new design

3 participants