GSA-TTS / FAC

GSA's Federal Audit Clearinghouse
Other
20 stars 5 forks source link

Create 'how to" for reading the basic search results table #4058

Open Leighdiddy opened 3 months ago

Leighdiddy commented 3 months ago

As a searcher of records on fac.gov basic search, I need a guide to understand what each column on the search results table means so that I can select the appropriate submission(s).

We currently do not have a how-to guide for interpreting our search results table. We want something similar to our current basic search filters guide.

Tasks

- [x] Audit columns
- [x] Write guide with explanation for each column
- [x] Build page
- [x] Add card to[ Search Resource](https://www.fac.gov/search-resources/) hub page
- [ ] (Optional) review guide with 2-4 users for feedback before pushing to site
- [ ] Have teammate review work
lauraherring commented 2 months ago

@James-Paul-Mason and @analynd I've got a first draft of this page built and I'd love any feedback you both have.

James-Paul-Mason commented 2 months ago

@lauraherring Just sent my notes via Google doc/email.

analynd commented 2 months ago

@lauraherring Looking good! I created this mural with my notes: https://app.mural.co/t/gsa6/m/gsa6/1722968168645/b4ff364531879fccde89a3e9182c554d11758d5e?sender=u657059c7ef2d757db0e10088

Lmk if you have any questions. Thanks!

lauraherring commented 2 months ago

@James-Paul-Mason and @analynd I've made some updates to the page based on your feedback and realizing we were missing some info. @jperson1 adding you as well for a quick look at how I've described the pagination and sorting features.

jperson1 commented 2 months ago

The pagination and sort portions look good to me! I like @analynd's comment on numbering the features.

lauraherring commented 2 months ago

Wow, somehow I completely missed @analynd's suggested mock-up. My bad! I'd like to talk through the potential ADA implications of numbering the columns in an image though.

lauraherring commented 2 months ago

Thanks to help from @Leighdiddy and based on @analynd's feedback, I updated the page with a shorter screenshot that should be ADA friendly.

Image

analynd commented 2 months ago

@lauraherring Noiceee! Looks great to me! 🥳 🙌

James-Paul-Mason commented 2 months ago

@lauraherring LGTM as well!

lauraherring commented 2 months ago

Thank you all! I just created PR #141 for this update.