Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Evaluate relevance and up-to-dateness of remaining links on UX Guide resources page #506

Open
3 of 18 tasks
dluetger opened this issue Mar 18, 2024 · 8 comments
Open
3 of 18 tasks
Assignees
Labels
Guides Initiative 2 Tracks work for "Improving the Maintainability of the 18F Guides and Methods"

Comments

@dluetger
Copy link
Collaborator

dluetger commented Mar 18, 2024

A description of the work

Background
Issue 291 removed the most irrelevant and any non-working links from the UX Guide resources page. Each link was evaluated and added to a spreadsheet for future reference.

Tasks

  • Consult the audit spreadsheet to get up to speed
  • Discuss among the UX team and discover which resources are still being used
  • Discuss with the UX team to determine if the resources still being used need to be updated
  • Decide whether to update any outdated resources as part of this ticket, or, if not, what ought to be done with outdated pages in the meantime
  • Decide where the internal-only links should live, and they've been moved accordingly

Point of contact on this issue
You can reach out to @bpdesigns, or @dluetger for context on what actually got done in 291.

Definition of done

TBD

Point of contact on this issue

@bpdesigns @dluetger

Reproduction steps (if necessary)

No response

Skills Needed

  • Any Human
  • Design
  • Content
  • Engineering
  • Acquisition
  • Product
  • Other

Does this need to happen in the next 2 weeks?

  • Yes
  • No

How much time do you anticipate this work taking?

~2 weeks, possibly more? Actually having the conversations about what belongs where and if things get used might take some time.

Acceptance Criteria

  • The resources have been discussed among the UX team to discover which ones are still being used
  • The resources have been discussed among the UX team to determine if the resources still being used need to be updated
  • A decision is reached on whether to update any outdated resources as part of this ticket, or, if not, what ought to be done with outdated pages in the meantime
  • A decision has been reached on where the internal-only links should live, and they've been moved accordingly
@dluetger dluetger added Initiative 2 Tracks work for "Improving the Maintainability of the 18F Guides and Methods" Guides labels Mar 18, 2024
@juliaklindpaintner
Copy link
Member

Thank you for creating this issue @dluetger! What's your take on whether this can feasibly be accomplished via TLC?

@dluetger
Copy link
Collaborator Author

I think it can, but might be a two-incrementer just based on calendar time. Because I anticipate needing to have some chats in UX huddle or just awaiting feedback in Slack and such. So there might be future breaking down of this ticket that we could do. Like "Discuss" and "Decide" or something.

Idk if it needs to be someone on UX team doing it. A non-UX, third-party facilitator could be a good approach but being familiar with the material might create some efficiencies.

@juliaklindpaintner
Copy link
Member

juliaklindpaintner commented Mar 27, 2024

The Design Chapter began reviewing some of these resources today during Crit — notes here and Google doc copies of the resources here! I'll work on creating some next step tickets based on that session.

@claireb-gsa
Copy link

A resource to flag:

under https://guides.18f.gov/ux-guide/resources/#general
there's a Artifacts from design-led projects

The folder isn't in our main structure - it requires permission, and is currently owned by @ lauraponce, but she isn't clear what the origin or purpose is.

@juliaklindpaintner
Copy link
Member

Hmm, it's showing to me as a folder in our 18F Team Folder > Design > Guides.
Screenshot 2024-03-28 at 5 18 49 PM

Are you seeing something else?

@claireb-gsa
Copy link

huh - I don't see the larger structure. Maybe there's a permission thing where access isn't consistent all the way down?
Screenshot 2024-03-29 at 12 03 30 PM

@juliaklindpaintner
Copy link
Member

@claireb-gsa Huh! Interesting. With the weird Google Drive permissions things that have been going on, I'm scared to make a change that might affect things all the way down the structure, but I'll investigate!

@juliaklindpaintner
Copy link
Member

In our 3/27 Design Chapter crit, designers reviewed some of the documents identified by Dave as needing review. The notes from that session are here. I am adding links to the documents we made to collect feedback and notes of next steps to the spreadsheet @dluetger created.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Guides Initiative 2 Tracks work for "Improving the Maintainability of the 18F Guides and Methods"
Projects
None yet
Development

No branches or pull requests

4 participants