@Falke-Design can this be submitted as a pull request to the openmaptiles-tools repo as a docs/ directory? I don't think there is any reason to create another repo just for a few documentation files just yet, but it is tools repo that has all the scripts to process the yaml files. Docs and examples are always welcome! You may also want to link to it from the main repo's README.

@nyurik Sure I will do if you want. For the documentation part it will make complete sense. But one of the other thoughts was, that also some other samples and nice-to-have layers can be added to this repo. Which makes the openmaptiles-tools bigger and adds stuff which the most people don't need.

@Falke-Design i think we should separate those two things (both are valid). Documentation should go into tools because that's where all the tooling is. Proposed layers should go into the OMT itself, and this is where we had a number of discussions of how to implement optional layers. I don't think we know how to do it just yet - there has been some discussion on the topic, and everyone recognizes it as a valid need, but clearly it should not be a part of documentation. Take a look at #970