Restructuring TARDIS Documentation (Issue #948)

[shreyansjain012]

This PR addresses some of the changes needed in TARDIS documentation.

Description

• docs/installation.rst: Rephrased the content
• docs/running/index.rst: Changed Running TARDIS to TARDIS Configuration File
• docs/running/interaction/integrator.ipynb → docs/configuration/integrator.ipynb
• docs/configuration/: Added a link to integrator
• The first link of the notebook given here was dead because of spacing between the name. Renamed reading blondin toymodel.ipynb to reading_blondin_toymodel.ipynb
• Many files still contains python2 syntax, update files to use python3 syntax

Motivation and Context

• Good documentation is always required for a large project.

• It partially fixes TARDIS documentation restructure (I of many) #948

How Has This Been Tested?

• Ran documentation on a local server using make html and verified that each change is working.

OS - Ubuntu 18.04

Screenshots (if appropriate):

Outdated syntax

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.

[shreyansjain012]

Please let me know if this PR needs some changes.
Also if you can elaborate these:

• move formal integral to configuration
• move stella to helper scripts

[jaladh-singhal]

@shreyansjain012 Please be more descriptive in your PR titles and description.

I think @wkerzendorf wants you to move this formal integral page under configuration section.

Additionally, have a look at past gitter chat where he explained about it

[shreyansjain012]

@shreyansjain012 Please be more descriptive in your PR titles and description.

I think @wkerzendorf wants you to move this formal integral page under configuration section.

Additionally, have a look at past gitter chat where he explained about it

I went to see previous chats but didn't find any mentions regarding this issue.
Care to explain it again? 😅

[jaladh-singhal]

Wait until @wkerzendorf can reply you back. Meanwhile, go through documentation and identify if there is something that needs to be restructured as per you?

[jaladh-singhal]

@shreyansjain012 It looks good to me so far!

@wkerzendorf could you cross-check parts specific to #948 like:

• Changed Running TARDIS to TARDIS Configuration File
• Moving formal integral to configuration

And give him more pointers about what you mean by "move stella to helper scripts"?

[ebjordi]

Hi! Please rebase this branch and check that there are no conflicts with the new documentation edits introduced in #1158.

[wkerzendorf]

closing as outdated