python-intermediate-development icon indicating copy to clipboard operation
python-intermediate-development copied to clipboard

Improve flow of the lesson in sections 4 and 5

Open anenadic opened this issue 1 year ago • 2 comments
trafficstars

A couple of issues:

  • do we need to fork the software repo - are we looking at past commits prior to forking at all?
  • we talk about releasing the project in section 4, fixing the documentation and readme and then we ask people in section 5 to open issues to fix these exact things
  • Exercise /52-assessing-software-suitability-improvement/index.html#exercise-conduct-assessment-on-third-party-software does not make much sense as the code is not developed enough and also all repos are the same
  • not sure that comments "### MODIFIED START ###" in code in episode https://carpentries-incubator.github.io/python-intermediate-development/36-architecture-revisited/index.html#adding-a-new-view mean

A better flow could be:

Section 4: Managing a Collaborative Software Project

  • Developing Software In a Team: Code Review
  • Improving Software Over Its Lifetime
    • Issues reporting and tracking
    • Software Improvement Through Feedback
  • Managing a Collaborative Software Project

Section 5: Releasing and Reusing Software

  • Preparing Software for Reuse and Release
    • Issue prioritisation
    • Planning sprinting and release cycles
  • Packaging Code for Release and Distribution

anenadic avatar Dec 21 '23 09:12 anenadic

Duplicate of #283.

anenadic avatar Apr 11 '24 14:04 anenadic

Needs discussing with the team.

anenadic avatar Jul 31 '24 10:07 anenadic