There is documentation on the README.md for libavr32. I do keep it up to date whenever I have issues, but a lot of the time things are reported on here without any corresponding PRs being opened when the fix is found.
The biggest issue IMO is that no one developer has practical access1 to WSL / Linux / macOS to keep the toolchain building scripts working. I think the Linux and WSL ones can be the same, but the macOS one requires different versions of some of the dependencies.
If we want to track it better we could make some changes to the monome/avr32-toolchain repo, perhaps some new branches:
-
master: just has a README.md explaining the other branches, a link to a thread on lines, and which user is responsible for each branch
-
macOS (or osx): version of the build script for macOS
-
linux: same but for Linux
-
wsl: you get the idea by now
Ideally we’d tag releases on master and then upload zipped avr32-tools directories onto the release page on GitHub for easy download.
I think for the time being just strongly encouraging people to keep the libavr32 README.md up to date is the easiest solution.
It’s definitely doable, but you’re still back with the issue of ensuring that the workflow is good for users of all 3 OSes. The Dockerfile itself would be pretty trivial I think.
There is already a .travis.yml file in most of the module repos, so PRs are already tested. I think build artefact uploading is a bit more complex, at least it was last time I looked at it. Admittedly the TravisCI workflow is horrid2, and one based on a Dockerfile would be much better.
FYI, for Teletype, running make release in the project root will run all the tests as well as zip up a firmware and all the documentation ready for uploading.
1 I can run Windows in a VM, but I don’t really know what I’m doing…
2 I really really hate writing .travis.yml files…