Having some ideas around improving MSW docs. Let's split it by API type, lay out all the relevant basics, techniques, and best practices right there. One play to learn everything about mocking that API.
Comments
Log in with your Bluesky account to leave a comment
I really like how it's going! I've drafted HTTP, GraphQL, WebSocket, and SSE, and it just feels right. I will be shipping this in the near future. The docs is something that can use improvement.
Yup. I even thought about having a “context” view once you’re in because chances are you’ll be interested only in one at a time. But it’s nice to see an overview of what else is available so people are not forced to pick one right away and know you do more than just HTTP
I really dig this.
Also a section on top:
- Intro, installation, quick start
- "MVP setup" - show me how it's done and I'll read the docs for the things that didn't immediately click
I do intend that if you want to mock an API type, you go and read its section. The root pages are somewhat mandatory, the expanding pages give you more targeted examples of how to do XYZ.
Comments
Also a section on top:
- Intro, installation, quick start
- "MVP setup" - show me how it's done and I'll read the docs for the things that didn't immediately click
I like the Quick start idea. That will likely be for HTTP in the... browser? Idk. It will always be a guess.