tickets/SP-845

[ryanlauastro]

DP0.2 Diaobject anomaly detection tutorial notebook

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[bnord]

General

1. “In order to” is a generally unnecessary phrase. It often feels better when we speak, but when written it can be replaced by “to.” Dealer’s choice, though.
2. Consider avoiding single-letter variables, like “x,” because those can easily be misunderstood by the user, or duplicated in a notebook, causing confusion by overwriting variables from another cell.
3. “I.e.” and “e.g.” always require a comma following them.
4. Consider changing the prose to avoid “In the following cell.” Consider writing the markdown such that it gives instruction. For example, “Next, make an array that blah blah.” This might make the text a bit more direct and easier to follow.
5. Pycodestyle violations remain to be addressed throughout notebook
6. Consider adding a top-level outline in list form or in prose form to help the user know what to expect as they navigate the notebook.

[bnord]

Comments are posted in the 'conversation'. I'm ready to review changes whenever ready.

[ryanlauastro]

Hi @bnord, alright, just updated the notebook and it should be ready for a follow up review.