Intermediate Python issueshttps://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues2020-07-23T15:24:29Zhttps://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/19recommend numpydocs format for docstrings?2020-07-23T15:24:29ZToby Hodgesrecommend numpydocs format for docstrings?use this instead of sphinx-style? https://numpydoc.readthedocs.io/en/latest/format.html
apparently this is becoming the standard, at least in the scientific Python community?use this instead of sphinx-style? https://numpydoc.readthedocs.io/en/latest/format.html
apparently this is becoming the standard, at least in the scientific Python community?https://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/17Working with argparse on windows2020-07-09T08:53:23ZRenato AlvesWorking with argparse on windowsConfusion about using the terminal.
We could recommend explicitly the Jupyter notebook terminal interface.
Some of the unix commands (`cat`, ...) aren't available.Confusion about using the terminal.
We could recommend explicitly the Jupyter notebook terminal interface.
Some of the unix commands (`cat`, ...) aren't available.https://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/14missing dependency for exercise 2.72020-07-08T10:04:00ZToby Hodgesmissing dependency for exercise 2.7`idxmax` should be introduced before it's used in exercise 2.7`idxmax` should be introduced before it's used in exercise 2.7Toby HodgesToby Hodgeshttps://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/13mention *args occurring with default parameters2020-07-06T15:19:22ZToby Hodgesmention *args occurring with default parametersAnother one from the course Slack:
> Comment/suggestion for "1.7. The pirate function definition" solution, referring back to the previous subsection where it mentions
> ```python
> # this will result in a SyntaxError
> def make_it_bigg...Another one from the course Slack:
> Comment/suggestion for "1.7. The pirate function definition" solution, referring back to the previous subsection where it mentions
> ```python
> # this will result in a SyntaxError
> def make_it_bigger(a, b=100, c):
> ```
> It could be emphasised, that this one
> ```python
> def give_rum(quantity=1, *what, to="all the crew!")
> ```
> doesn't cause an exception since the "*what" is actually a reference and defaults to `()` if not provided.https://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/11TODO after July 2020 course2020-07-09T12:10:49ZToby HodgesTODO after July 2020 course- [ ] adjust/remove teaching/exercises timing estimates for each episode
- [ ] add more explanation/demonstration of the use of `yield`, maybe side-by-side comparison of a definition with `return` vs `yield`
- [ ] provide more info about...- [ ] adjust/remove teaching/exercises timing estimates for each episode
- [ ] add more explanation/demonstration of the use of `yield`, maybe side-by-side comparison of a definition with `return` vs `yield`
- [ ] provide more info about `set`s and their methods
- [ ] add "How to Jupyter" page to Extras
- [ ] annotate code blocks in solutions more often?
- [x] make heading levels consistent between chapters
- [ ] add "glossary" section to end of each chapter
- [ ] add section to Setup with link to download all data
- [ ] align keypoints with content in `01-syntax`
- [ ] add more explanation to/re-work exercise 4.2
- [ ] mention `action` parameter for `argparse` arguments
- [ ] add example of where argparse won't catch problems with user input e.g. file doesn't exist, numbers that must be within some range/one larger than the other, etc
- [ ] add link to example/tutorial on `black` use in CI
- [ ] collect/add more reference to recommended resources for further reading, etchttps://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/5Have a "summary of functions/keywords" using in this lesson2020-07-05T07:26:04ZRenato AlvesHave a "summary of functions/keywords" using in this lessonLike in the Introduction to R course, this kind of summary was useful both for instructors and participants.
It's also a great "go back to" resource acting as a kind of cheat sheet.Like in the Introduction to R course, this kind of summary was useful both for instructors and participants.
It's also a great "go back to" resource acting as a kind of cheat sheet.https://git.embl.de/grp-bio-it-workshops/intermediate-python/-/issues/2add info about development environment to Setup2020-06-05T08:28:38ZToby Hodgesadd info about development environment to Setupbefore the course starts, we should make sure all participants have a suitable development environment to use - need to decide on what option(s) to recommend and then add instructions to the Setup page.before the course starts, we should make sure all participants have a suitable development environment to use - need to decide on what option(s) to recommend and then add instructions to the Setup page.