The-turing-way: Reorganise chapters into subsections

[rainsworth]

Summary

Currently, most of the chapters are one long page. We would like each chapter to be restructured into subsections like the chapter on Reproducibility which was done in this pull request:
https://github.com/alan-turing-institute/the-turing-way-book/pull/12

(*Note that we are no longer using a separate GitHub repository for the book, sorry for any confusion linking to a different repo pull request here!)

What needs to be done?

• [x] Restructure Open Research chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Version Control chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Collaborating on GitHub/GitLab chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Research Data Management chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Reproducible Environments chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Testing chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Reviewing chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Continuous Integration chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Reproducible Research with Make chapter
  
  
  
  • [x] Update the Table of Contents
  
  
• [x] Restructure Risk Assessment chapter
  
  
  
  • [x] Update the Table of Contents
  
  

Who can help?

• Anyone who wants to test out their GitHub skills! :) You can see how it was done previously in this pull request: https://github.com/alan-turing-institute/the-turing-way-book/pull/12

---

Updates

[jspickering]

I'm going to try and restructure the Open Research chapter - my first pull request incoming in...some short time in the future :)

[rainsworth]

Thank you so much @jspickering! 👏 Would you be able to update the Table of Contents to reflect the new sections? If you've moved on to something else @pherterich or I could take a crack at it :)

[jspickering]

I've edited the Table of Contents file!

[rosiehigman]

I'm going to have a go at restructuring the Risk Assessment chapter

[jspickering]

I'll restructure the Version Control chapter

Edit: I will leave this for someone at the London book dash! :)

[cassgvp]

I'll restructure the Version Control chapter

Edit: I will leave this for someone at the London book dash! :)

• I'll pick this up! 💃

[rosiehigman]

I'll pick up the Collaborating with GitHub/GitLab chapter

[masonlr]

I'll pick up the Reproducible Environments chapter with PR https://github.com/alan-turing-institute/the-turing-way/pull/575

[masonlr]

Please note:

1. Each PR will need to update website/_data/toc.yaml

2. Any table-of-contents markdown content will need to be edited to reference external files: for example if you had a reference to content in the current file

   - [Binder](#Binder_section)
   

   and then moved to a new file ./04/binder.md, you'll need to update the link to

   - [Binder](./04/binder#Binder_section)
   

[rainsworth]

Please note:

1. Each PR will need to update `website/_data/toc.yaml`

2. Any table-of-contents markdown content will need to be edited to reference external files: for example if you had a reference to content in the current file
   ```
   - [Binder](#Binder_section)
   ```


   and then moved to a new file `./04/binder.md`, you'll need to update the link to
   ```
   - [Binder](./04/binder#Binder_section)
   ```

Thank you @masonlr, I'll get these instructions added to the Contributing Guidelines!

[masonlr]

@rainsworth can we decide whether manual TOC entries are still needed in the book? See a new issue here https://github.com/alan-turing-institute/the-turing-way/issues/581

[rosiehigman]

I'll take the Reviewing chapter, will remove the manual TOC as per @masonlr suggestion in #581

[rosiehigman]

I'll take the Testing chapter

[christopherlovell]

I can reorganise the version control chapter if no one else is doing this?

[masonlr]

@christopherlovell go for it.

[KirstieJane]

Thank you @christopherlovell!

[christopherlovell]

pull request submitted #729

(and my bad spelling fixed...)

[dblana]

I will attempt to restructure the Research Data Management chapter...

[malvikasharan]

Thank you for working on these chapters. Many of these changes have been accepted to the current version, thanks to many of you. ❤️️

Please see #977 for the chapters with subsections. I will keep this issue open till we get the PR merged.