Let's have a Wiki (again)
In my talk today with Hans at our regular "Office Hour" we agreed it would be nice to have a Wiki again. My idea was to use it for documenting our processes, helpful hints for our daily work, etc. It could also serve as a "brain-storming center" for new documentation to be added to f-droid.org/docs – which is why I'd propose using the GitLab wiki of "website" for this.
Some points I'd like to see there (and collected details on during the last months):
- how often does X run and what triggers it (with X in checkupdates, build, sign)
- common errors with build runs and possible approaches (e.g. "Unable to strip the following libraries, packaging them as they are: XXX.so, ..." usually meaning the build block needs
ndk: r21d
or whatever NDK is available then) - hints for setting up specific build blocks (eg for Flutter apps: have
prebuild: echo "flutter.sdk=$$flutter$$" >> ../local.properties
, make surebuild:
has the$$flutter$$/bin/flutter config --no-analytics
step, and more)
All these things are easier "grown" (and found) in a wiki. Sure: as soon they are "grown", most of them probably should be added to /docs
, though certainly not all.
While Hans proposed a separate "project" for that, fearing it otherwise would get lost, I think binding it to the repository our docs reside in would to be preferred. It's about documentation, so it somehow belongs. Of course I'm open for alternative ideas, too