Merge ubuntu-release-tools:schedule-clarity into ubuntu-release-tools:main

[Brian Murray]

[Iain Lane (laney)]

This looks great, thank you!

Assuming you tested it and the output is correct 👍

review: Approve

diff --git a/generate-release-schedule-markdown b/generate-release-schedule-markdown
index ed31bb1..6e68392 100755
--- a/generate-release-schedule-markdown
+++ b/generate-release-schedule-markdown
@@ -108,7 +108,7 @@ After [Final Beta](https://wiki.ubuntu.com/FinalBetaRelease), all members of the
             # October release
             nweeks = release_week_number - start_week_number
         else:
-            nweeks = (52 - start_week_number + 1) + release_week_number
+            nweeks = (52 - start_week_number) + release_week_number
         # Week 1's Thursday is the Thursday AFTER the previous release
         current_date = self.start_date + timedelta(weeks=1)
         last_month = None
@@ -199,18 +199,24 @@ if __name__ == "__main__":
     parser = argparse.ArgumentParser(
         description="Make a release schedule in markdown format"
     )
-    parser.add_argument("codename", metavar="CODENAME", type=str)
-    parser.add_argument("start", metavar="START", type=datetime.fromisoformat)
+    parser.add_argument("codename", metavar="CODENAME", type=str,
+        help="Code name for the release"
+    )
+    parser.add_argument("previous_release_date", metavar="START",
+        type=datetime.fromisoformat, help="Release day of the previous release"
+    )
     parser.add_argument(
-        "release", metavar="RELEASEDAY", type=datetime.fromisoformat
+        "release", metavar="RELEASEDAY", type=datetime.fromisoformat,
+        help="Release day of this release"
     )
     try:
         args = parser.parse_args()
 
-        raise_if_not_thursday(args.start)
+        raise_if_not_thursday(args.previous_release_date)
         raise_if_not_thursday(args.release)
 
-        sched = ReleaseSchedule(args.codename, args.start, args.release)
+        sched = ReleaseSchedule(args.codename, args.previous_release_date,
+                                args.release)
         print(sched)
     except ValueError as e:
         print(e, file=sys.stderr)