WIP - Add Notebook Authoring Guide #127
Conversation
trallard
added
type: enhancement 💅🏼
There was a problem hiding this comment.
This seems accurate and comprehensive to me! Thank you for reading through the recommendations and working to make them fit here.
I've been staring at this trying to give a good review and I'm not confident in all these comments. I feel like there may be another way to structure some of this, but I will have to keep thinking on it. I do like that this structure allows readers to jump to parts that may be relevant to them (ie. only reading the Visualizations section or the like).
I'm also considering whether or not a short list might be helpful. As usual, I'm open to feedback on all that. Thank you so much for taking a stab at these dense documents and making something new from them!
|
|
||
| All the information presented is based on the [draft authoring tips](https://github.com/Iota-School/notebooks-for-all/blob/main/resources/event-hackathon/accessibility-tips-for-jupyter-notebooks.md) and the [Notebook authoring accessibility checklist](https://github.com/Iota-School/notebooks-for-all/blob/main/resources/event-hackathon/notebook-authoring-checklist.md) from the Notebooks For All team. | ||
|
|
||
| # Table of contents |
There was a problem hiding this comment.
Thank you for keeping this! I'm noticing it's gummed up in some sources on the original documents, so I'm grateful you took the time to add it properly here.
There was a problem hiding this comment.
I think it is important to point where all the original information is
trallard
changed the title
Co-authored-by: Isabela Presedo-Floyd <[email protected]>
trallard
added
status: on hold ⛔️
|
Closing this for now as we plan the format/path forward |
This PR,
This PR is part of #125
📚 Documentation preview 📚: https://jupyter-accessibility--127.org.readthedocs.build/en/127/