Vladimir, welcome! >consistent signal from the "field" - lack of documentation blocks
I wonder if logging "missing sections" would help. The catch here is if you work with Calcite for some time the missing docs become a blind spot. For instance, once I heard that if one wants to add a test case, then it is not clear which class/approach is appropriate. If you think about it, we do have multiple ways to create tests at different levels, however, we do not suggest entry points or something like that. It might probably help if there was a layered diagram with pointers to the test class samples. Vladimir