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

🟡 Draft content for diagramming/modeling practices #303

Closed
1 of 10 tasks
Tracked by #350 ...
MelissaBraxton opened this issue Mar 23, 2023 · 7 comments
Closed
1 of 10 tasks
Tracked by #350 ...

🟡 Draft content for diagramming/modeling practices #303

MelissaBraxton opened this issue Mar 23, 2023 · 7 comments
Labels
Guides Initiative 2 Tracks work for "Improving the Maintainability of the 18F Guides and Methods" UX Task related to the UX Guide and/or pulled from the old UX Guide repo.

Comments

@MelissaBraxton
Copy link
Contributor

Before you submit your new issue, add labels so that we know which guide/site the work is relevant to. E.g., if the work needs to be done on both the UX guide and the methods cards sites, then add the "UX guide" and the "method cards" labels. Once you're done, delete the text above the line. :)

While it might seem redundant, we have one team that manages issues across multiple products, and these labels help us keep our wires straight!


Point of contact on this issue

@bpdesigns or @MelissaBraxton


Timeline
Does this need to happen in the next two weeks?

  • Yes
  • No

How much time do you anticipate this work taking?
1-2 weeks

Background
The UX Guide is heavily skewed toward research and does not cover diagramming and modeling design approaches that are very common at 18F. This issue covers drafting content to describe how we create diagrams, maps, and models to help us identify and understand problems, make sense of complexity, and explore solution ideas.

This issue could be broken up into smaller chunks if need be. One example of how it could be broken up:

  • Make an outline
  • 1st draft
  • shepherd content through review/approval processes
  • Address requested revisions and comments
  • Implement content in code

The work could also be broken up by different diagramming approaches (system map, task flow, service blueprint, mental model, etc.)

Acceptance criteria (we'll know we're done when…)

  • Content that describes how 18F designers use diagramming, mapping, modeling in their design practice is live in the UX guide

Tasks

  • Make an outline
  • Write content
  • PO review [if task involves content changes]
  • Refine comment based on feedback
  • Implement content
  • Accessibility review [if needed]
  • Outreach approval [if needed]
@MelissaBraxton
Copy link
Contributor Author

@bpdesigns - The SD working group was hoping we could shape up this issue to be picked up or at least started by the DA team. Take a look and let me know what you think!

@bpdesigns
Copy link
Member

bpdesigns commented Mar 24, 2023

Seems good to me. This also makes me think its time to revisit this ticket on navigation #403 and this ticket on duplicative content across the 18F methods and ux guide #397

@bpdesigns bpdesigns changed the title Draft new content for the UX Guide "design" section on diagramming/modeling Draft content for diagramming/modeling practices May 9, 2023
@lauranash18f
Copy link

We have slides/recording/transcripts from Abby Covert's How to Diagram training last year, which should help the future author! https://drive.google.com/drive/folders/1Kww85gsre2Fi_9EKNBJKw99tvzQ4vmZj?usp=share_link

@christophermather christophermather transferred this issue from 18F/ux-guide Dec 19, 2023
@christophermather christophermather added the UX Task related to the UX Guide and/or pulled from the old UX Guide repo. label Dec 20, 2023
@christophermather christophermather added Initiative 2 Tracks work for "Improving the Maintainability of the 18F Guides and Methods" Guides labels Dec 22, 2023
@juliaklindpaintner juliaklindpaintner changed the title Draft content for diagramming/modeling practices 🟠 Draft content for diagramming/modeling practices Feb 23, 2024
@juliaklindpaintner juliaklindpaintner changed the title 🟠 Draft content for diagramming/modeling practices 🟡 Draft content for diagramming/modeling practices Feb 23, 2024
@elisaachen
Copy link

@katefisher808 Were you the original author for this idea?

@katefisher808
Copy link
Member

I think it came out of an early service design brainstorm, possibly with @lauranash18f ! I don't remember who exactly drafted the idea though. How can I help, if at all.

@lauranash18f
Copy link

Yep, this came out of our service design meeting + diagram training! I am also happy to do something to help move this forward if needed, happy to stay out of it if not needed!

@bpdesigns
Copy link
Member

@lauranash18f I'm closing this ticket because the UX guide discusses prototyping as a practice and building a prototype that references service design methods, as well as choosing service design methods

cc: @elisaachen @MelissaBraxton for reference. Please reopen if there is something I'm missing. The SD team helped with a content refresh maybe a year ago and added some SD content.

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" UX Task related to the UX Guide and/or pulled from the old UX Guide repo.
Development

No branches or pull requests

6 participants