meta-issue: learn-ocaml 0.13.1, 0.14.0 release plan and milestones suggestions for upcoming releases

[erikmd]

Hi all,

This issue aims to document the release plan as well as possible milestones for issues/PRs before setting them.

We'll close this issue as soon as learn-ocaml 0.14.0 is released.

(feel free to comment below for questions/remarks if need be)

0.13.1

• [x] @erikmd Fix "Actions" menubar button https://github.com/ocaml-sf/learn-ocaml/issues/444
  https://github.com/ocaml-sf/learn-ocaml/pull/450
• [x] Integrate Pierre.Letouzey's bugfix https://github.com/ocaml-sf/learn-ocaml/issues/440
  https://github.com/ocaml-sf/learn-ocaml/pull/448
• [x] @erikmd Fix DOCTYPE-related issue
  https://github.com/ocaml-sf/learn-ocaml/pull/445
• [x] @erikmd Double-check GHA w.r.t. docker-push and Docker image tags convention (v-prefix-free)
  https://github.com/ocaml-sf/learn-ocaml/pull/443
• [x] @AltGr Fix Progress bar for students is not displayed on a fresh repository / Fail to view student contributions
  https://github.com/ocaml-sf/learn-ocaml/issues/314
  https://github.com/ocaml-sf/learn-ocaml/issues/337
  https://github.com/ocaml-sf/learn-ocaml/pull/439

0.14.0

• [x] @erikmd Reportbug(release-please): missing feature for *.opam.locked
• [x] @erikmd Task Update devs/maintainers doc regarding the constraints suggested by the release-please workflow
  → https://github.com/ocaml-sf/learn-ocaml/wiki/Checklist-for-testing-and-merging-a-PR
• [x] @erikmd Task Document contributor guidelines in CONTRIBUTING.md, including Conventional Commits, BREAKING-CHANGE syntax, structure of a PR https://github.com/ocaml-sf/learn-ocaml/pull/452
  https://github.com/ocaml-sf/learn-ocaml/pull/453 https://github.com/ocaml-sf/learn-ocaml/pull/464
• [x] @erikmd Fix-or-Disable learn-ocaml build -j 2 https://github.com/ocaml-sf/learn-ocaml/issues/414
  https://github.com/ocaml-sf/learn-ocaml/pull/416 • Draft
  https://github.com/ocaml-sf/learn-ocaml/pull/458 (first commit)
• [x] Merge various bug fixes https://github.com/ocaml-sf/learn-ocaml/pull/459
  https://github.com/ocaml-sf/learn-ocaml/pull/461 https://github.com/ocaml-sf/learn-ocaml/pull/455
• [x] @yurug Rebase/Test/Merge Offer better protections against solution overwriting
  https://github.com/ocaml-sf/learn-ocaml/pull/372 opened on Dec 22, 2020 by yurug
• ~~Enhance the web UX for students clicking too much on Sync, avoiding empty commits. → subsumed by #372~~

0.14.1

• @yurug / @erikmd CI: Fix linux static binaries build
• Release PRs currently integrated in master
  (cf. https://github.com/ocaml-sf/learn-ocaml/pull/486 )

1.0.0

pre-compilation of graders

• @erikmd Implement learn-ocaml-mode compat with #481
• @erikmd Integrate #481
• @erikmd Fix front-end /description w.r.t. static deployment
• @erikmd Refactor(deploy-*.yml): docker/build-push-action@v2

1.1.0 or later

todo:

• discus long-term maintenance of ocaml version compatibility

Vg release:

• @yurug Dev vg (part in master + more upcoming)

teacher stream:

• Dev Make it possible for teachers to (edit the students' code, or) provide the students with a stream of comments from the teacher, including fragments of the answer, that can be consulted anytime and be marked as read by the student

oauth-moodle release:

• @erikmd Dev Backport learn-ocaml-client improvements from branch oauth-moodle
• @erikmd Rebase/Finalize Add support for Moodle/LTI and email/password-based authentication
  https://github.com/ocaml-sf/learn-ocaml/pull/362 opened on Sep 16, 2020 by erikmd
  (missing: learn-ocaml.opam update, DB fixes, doc)

multi-part :

• Dev Implement multi-part exercises feature
  https://github.com/ocaml-sf/learn-ocaml/pull/402 opened on Jun 23 by YoanwM • Draft

learn-ocaml-editor:

• @erikmd Rebase/Polish Integrate learn-ocaml-editor
  https://github.com/ocaml-sf/learn-ocaml/pull/295 opened on Jul 5, 2019 by erikmd • Draft

documentation:

• @erikmd Doc the procedure to fetch/use macOS binaries
• @erikmd Doc markdown-to-html (feature already in master): needs some documentation update
• @erikmd Doc Add more labels, inspired by PG/Coq GH repos?
• @erikmd Doc Add Markdown badges?

more features:

• Dev Make the Git history available (at least in part), from the students' web UI
• Task Improve dev. documentation (e.g., mentioning direnv, magit, git prompt…)

2.0.0

• Merge feat!: add Makefile rule for formatting
  https://github.com/ocaml-sf/learn-ocaml/pull/407 opened on Jul 28 by EmileRolley • Draft

[erikmd]

If no one objects, I'll integrate #439 and release 0.13.1 tonight. Feel free to open another issue meanwhile if you see other usability issues.

[erikmd]

This run unfortunately errored with a spurious (network) failure:

https://github.com/ocaml-sf/learn-ocaml/runs/3911828459?check_suite_focus=true

FTR, here was the log before I restarted the build:

Successfully built 7b1661595884
Successfully tagged ocamlsf/learn-ocaml:master
Pushing image [ocamlsf/learn-ocaml:master]
The push refers to repository [docker.io/ocamlsf/learn-ocaml]
31255f3702b3: Preparing
34c165827557: Preparing
060585235be3: Preparing
f1dd685eb59e: Preparing
f1dd685eb59e: Layer already exists
34c165827557: Pushed
060585235be3: Pushed
31255f3702b3: Pushed
received unexpected HTTP status: 504 Gateway Time-out
Error: exit status 1
Usage:
  github-actions build-push [flags]

[erikmd]

The CI/CD builds are complete, and everything looks fine; so I updated the announcement here: https://discuss.ocaml.org/t/ann-release-of-ocaml-sf-learn-ocaml-0-13-0/8577/6

[erikmd]

Closed by #486