[BUG] Maintaining Consistency in binderhub-resources.md
#1,503 opened on Nov 3, 2020
Description
Summary of Issue
The Turing Way project is an open-source endeavour that empowers contributors from around the world to leverage their skills, knowledge and expertise to build and expand its content. The Turing Way guides are evolving with multiple chapters co-developed by individuals from varied backgrounds, who are all passionate about sharing knowledge around data science and research. To sustain and support this vibrant community, The Turing Way book must remain consistent and accessible as it evolves. Although the style guide chapter already outlines guidelines for keeping a consistent style across the book, not all chapters follow these suggestions as they have been written asynchronously by different authors.
We have curated a consistency checklist that chapters in The Turing Way need to pass to help us maintain a consistent style across the book. However, we need your help to push this forward!
For reference, the checklist is discussed in the chapter on maintaining consistency in The Turing Way. There you can also find useful instructions on how to address these issues
At the time that this issue was created, the maintaining consistency chapter is yet to be merged. However, you can check out the PR here
What needs to be done
This issue focuses on maintaining consistency in Definitions subchapter of the Overview chapter in the Guide to Reproducible Research. To help with this, we invite contributors to do the following:
- File Location: book/website/reproducible-research/binderhub/binderhub-resources.md
- Latest commit when this issue was created: d1e7565
File Specific Checklist
- Add labels to headers and images to enable cross-referencing as described in the style guide
- Fix chapter structure by ensuring it follows the recommended structure described in this chapter template
- rename
Resources for BinderHubtoResourcesin _toc.yml - rename
Definitions\glossaryto Glossary, change from table to list - rename
References specific for this chaptertoReferences - create a separate file for Checklists file (binderhub-checklist.md) that should come before the Resources
- rename
How you can help
- Please pick a consistency check from the checklist above (check it off from the issue description)
- Comment below what consistency check you would like to work on
- Work on your contributions locally or on Github
- Raise a PR for your contributions to be reviewed and integrated in The Turing Way repo!
Who can help
Anyone who would like to make the The Turing Way as consistent and polished as possible. We especially welcome new contributors to try their hand on this!
For any questions, comments, suggestions, or feedback, please comment below :muscle: