docs: update guide sidebar, add more recipes#10226
Conversation
✅ Deploy Preview for vitest-dev ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
AriPerkkio
left a comment
AriPerkkio
left a comment
There was a problem hiding this comment.
I think we should have a "landing page" on the Guides tab. It should describe what sections there are on the sidebar. It would be duplicate content, but it would be more verbose than the actual sidebar. Right now we are expecting users to check sidebar for all sections when they land on guides.
| # Parallel and Sequential Test Files | ||
|
|
||
| Most test files are independent and run faster in parallel. The exception is the handful that share an exclusive resource, like a fixed port, a writable temp directory, or a database without per-test isolation. Those files flake when other tests run concurrently with them. | ||
|
|
||
| Disabling parallelism globally would slow down every test in the suite. Splitting the suite into two [`projects`](/guide/projects), one parallel and one sequential, lets only the affected files pay the cost. |
There was a problem hiding this comment.
Would be nice to have an illustration picture here showing what parallel and sequential means.
There was a problem hiding this comment.
I'm gonna merge this and add a comment to create a follow up to have this image, otherwise we will never merge this 😭
|
Astro's recipes look like this also with landing page https://docs.astro.build/en/recipes/ |
AriPerkkio
left a comment
AriPerkkio
left a comment
There was a problem hiding this comment.
Overall looks good! Recipes are great 💯
3 participants
Over time I am noticing it is hard for users to discover new features that we release. They usually get buried in blog or mentioned off-hand in the api/guide section.
This PR tries to change that by adding new recipes for the features that we added in the last several majors. The content was initially generated by claude, then re-prompted and reviewed by me
Additionally, I restructured the "Guides" sidebar because it became hard to distinguish between entries, it became a huge list of articles. Hopefully grouping them distinguishes them more