-
Couldn't load subscription status.
- Fork 401
Add an examples explanation contribution page #1949
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add an examples explanation contribution page #1949
Conversation
Co-authored-by: Gilles Henaux <[email protected]>
Co-authored-by: Gilles Henaux <[email protected]>
Co-authored-by: Gilles Henaux <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is good content: the advice is clear, helpful and uncontroversial. Sorry for letting this languish!
I'm going to merge this and build on it: I have larger refactors for how we use examples planned :)
|
Thank you! Looking forward to seeing what's built on it 🫡 |
This is a style guide for writing explanations for examples, designed following conversations12 in the discord and the development of doup's docs extraction.
This is an edited version of the hackMD document (which featured 3 examples) that I've posted to the discord a few times, to make it a bit closer to the surrounding contribution guide.
This PR needs some more feedback, there's divergence from the writing docs guide in terms of "who is looking at this" that I'm not sure is necessary, and some things may have been cut from the hackMD doc that shouldn't have been.
Footnotes
(original conversation) https://discord.com/channels/691052431525675048/1316318586247315487/1316384953390600223 ↩
(more recent feedback) https://discord.com/channels/691052431525675048/743559241461399582/1331017971862208590 ↩