Skip to content

Commit

Permalink
Work on article
Browse files Browse the repository at this point in the history
  • Loading branch information
basham committed Sep 17, 2024
1 parent bcade98 commit 3fdba21
Show file tree
Hide file tree
Showing 3 changed files with 311 additions and 100 deletions.
7 changes: 5 additions & 2 deletions src/components/CodeFigure.astro
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,11 @@ const { label } = Astro.props;
padding: 1em;
}

:global(figure:has(pre.astro-code:focus)) {
border-color: var(--color-link);
}

:global(figure pre.astro-code:focus) {
outline: var(--2px) solid var(--color-link);
outline-offset: calc(var(--4px) * -1);
outline: none;
}
</style>
4 changes: 2 additions & 2 deletions src/content/writings/2024-08-20-useful.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ import Figure from '@components/Figure.astro';
1. Writing should be useful
2. [Writing should be usable](/2024-08-22/usable)
3. [Writing should be kind](/2024-08-22/kind)

Workshop: [Writing for Product Teams](https://github.com/basham/swit-workshop-writing) (2024)
</Aside>

This is the start of a series about UX writing, based on my workshop [*Writing for Product Teams*](https://github.com/basham/swit-workshop-writing). Over the series, I explain three tenets: The writing we use in digital products should be useful, usable, and kind.
Expand Down Expand Up @@ -46,8 +48,6 @@ The more you know about another person, the more effective your conversation. Yo
2. **Research your audience:** Ask questions to learn about your audience's knowledge, expertise, interests, concerns, needs, tasks, and goals.
3. **Write for your audience:** Write in a way to help your audience find the content they need, understand that content, and then use that content to meet their goals. Speak to the user as a member of your audience.

---

## Mutual benefits

Because you know your audience, you can make the conversation easy for them. Be cooperative. Reduce the required effort or upfront knowledge they need to engage in the exchange. The conversation should be mutually beneficial. Each side should be satisfied with what they invested in it and what resulted from it.
Expand Down
Loading

0 comments on commit 3fdba21

Please sign in to comment.