We write explanations of programming concepts, and we made this site to get feedback from readers.
We find that the best way to find out if documention is working is to directly ask you (the person who's trying to learn from it!) if it makes sense to you. If you're confused by something, probably 1000 other people are confused by it too, so we want to hear about it!
Our dream is give readers of the docs a more of a voice. Everyday users of a technology are the ones who know if the docs are useful, but docs are often written and reviewed by the most advanced users, who have forgotten what it's like for most people.
Thanks so much for leaving us feedback!
- Julia & Marie
A few technical notes about the site:
- We store as little personal information as possible: just whatever name you enter.
- This site isn't designed to be used on mobile.
- All your feedback is automatically saved on the server.
FAQ
Can I get feedback on my own documents using this site?
Email me at julia (at) wizardzines.com with a sentence about what you're working on if you'd like an invite.
Is this open source?
Yes! Here's the GitHub repo. If you run into issues while giving feedback, I'd love it if you reported a bug there!
Credits
This site was made by Marie Clare LeBlanc Flanagan and Julia Evans for Wizard Zines. It's heavily inspired by Help This Book. The color palette is uchū.