A bit of a long rant, still the core of the argument stays true. Apple will do everything in its power to keep their platform captive of their app store.

Good advice yes. Having a rough architecture document in a repository is more than welcome, it's needed to help on-boarding. This is unfortunately not the norm in FOSS projects.