great question. @User .. so right now it is in folders... which is a bit of an issue. basically in the beginning we are taking advantage of the fact that we can use the built in web IDE in gitlab to edit things.
i could easily move this to hierarchies, and i think i will do that. my concern with using hierarchies is that it might be more difficult for people visually inspecting the repo to look at where to find documentation, but i believe they can just use the search feature and that would work fine. i'm also going to turn this repo into a dendron published site, so that will definitely help with organization.
@User we are actually a very small team, so there is not a lot that we need to export. if we do need to export things we will probably do so manually, but it's really not a big deal for us right now. to support tables and graphs i am going to try to lead by example by using text tables / mermaid syntax.