---
# System prepended metadata

title: Talking and Doc'ing 2024-05-02
tags: [Talking and Doc'ing]

---

# Talking and Doc'ing 2024-05-02

## Are you ready to get your `<Steps>` today???

(This document is available at: https://hackmd.io/@astrodocs/By8qNlbMC)

Thanks to @egpereira, we have... "a few" new Docs PRs to review. These PRs add the new Starlight `<Steps>` component to existing ordered lists.

![image](https://hackmd.io/_uploads/B1pr2lWfR.png)


Each use will need to be visually inspected in the deploy preview to make sure it's rendering properly.

Here's how you can help!

1. Choose any of [the open PRs about adding the Steps component](https://github.com/withastro/docs/pulls?q=is%3Apr+is%3Aopen+-label%3Ai18n+author%3Aegpereira+sort%3Acomments-asc). Post in Talking and Doc'ing chat which one you are reviewing so that others can choose a different one.
2. Open the deploy preview and navigate to the page from the PR title. ![Screenshot 2024-05-02 08.19.25](https://hackmd.io/_uploads/SkVMDgbGR.png)
3. Visually inspect the page looking at all uses of the new `<Steps>` component. (There may be more than one on a page.)
4. If you notice something that needs attention or fixing, make a suggestion (if you feel you can correct it) or leave a comment explaining what you noticed. Screenshots are often helpful. Be on the lookout for:
    - Incorrect indentation (especially if steps contain code blocks)
    - Lists of items that are *not* steps using the component. For example, a list of "the three parts of a flower" *will* be an ordered list but are *not* a set of steps for the reader to take.
    - Problems when steps continue across different sections of a page.
5. If you are unsure about something, ask in chat and we will discuss!
6. If you think the page is good to go, either leave a comment saying so or use the "approve now" link and type a short message.

Let's see how many we can get through!
