Docs Need Update

[wadethestealth]

Documentation Changes Needed:

• [X] 1. Move cell information to a more visible location (and maybe multiple locations or redirect with header link)

  • Seems like their is a lot of information regarding cells and how to make them in docs/Usage/NotebookFiles.md, this should be moved somewhere else. Not everyone may be importing and exporting. A good place could be in the "Gettting Started" page.
  • Done by #1745

• [ ] 2. Update the Troubleshooting Doc with the issues linked and all the different solution types.

  • Issues: #1684, #1665, #1550, #1517, #1500, #1405. The solutions may need to be sorted and then throwaway if they are too complex or have no benefit over another.

• [ ] 3. Add a Doc for Hydrogen Settings and what they do.

  • While we do provide a description, sometimes that is not enough and can lead to a lot of confusion. It may be helpful to provide examples of our settings.
  • This stems from the languageMappings setting, which seems to confuse people regularly even our contributors sometimes.

[Purukitto]

If this Issue still needs attention, I'd like to contribute

[aviatesk]

@Purukitto Thanks for the message ! Yes we DO need the help.

In my opinion, we especially need an update for

1. Move cell information to a more visible location (and maybe multiple locations or redirect with header link)

   • Seems like their is a lot of information regarding cells and how to make them in docs/Usage/NotebookFiles.md, this should be moved somewhere else. Not everyone may be importing and exporting. A good place could be in the "Gettting Started" page.

In addition to the examples @wadethestealth mentioned above, the new documentation for upcoming features like:

• completion descriptions: https://github.com/nteract/hydrogen/pull/1727
• support for vega-3: https://github.com/nteract/hydrogen/pull/1724
• ~inspection datatip: https://github.com/nteract/hydrogen/pull/1710~
• import results: https://github.com/nteract/hydrogen/pull/1715

are really welcome.

[Purukitto]

@aviatesk

In my opinion, we especially need an update for

1. Move cell information to a more visible location (and maybe multiple locations or redirect with header link)

   • Seems like their is a lot of information regarding cells and how to make them in docs/Usage/NotebookFiles.md, this should be moved somewhere else. Not everyone may be importing and exporting. A good place could be in the "Gettting Started" page.

I'll start with this then 👍

[aviatesk]

Cool, looking forward to your PR !

xref:

• https://github.com/nteract/hydrogen/pull/1628
• https://nteract.gitbooks.io/hydrogen/docs/Usage/NotebookFiles.html

[Purukitto]

Cool, looking forward to your PR !

Only pushing update in the docs/Usage/NotebookFiles.md file would be enough or parallel changes are needed on some other files?

Also I feel that adding a separate page under usage for Cells should be a good idea

[aviatesk]

Also I feel that adding a separate page under usage for Cells should be a good idea

This sounds better. Maybe adding something like docs/Usage/Cells.md. Additionally mentioning that in docs/Usage/GettingStarted.md also could be helpful.

[Purukitto]

@aviatesk I thought of mentioning it in Getting started but later thought better off it. Knowledge about 'Cell Markers' is necessary as such to get started so I didn't find it fitting. Also the Getting Started page already references "Export" which in turn references "Cells" so it should be fine