That is a limitation of the tooling we have unfortunately. Every line in the text files that is not code increases the cognitive load of the person when not dir

That is a limitation of the tooling we have unfortunately. Every line in the text files that is not code increases the cognitive load of the person when not directly relevant. And unfortunately a lot of development is done on laptops or otherwise screen restrained machines. I agree in principle that the metadata and code should be linked and easily pop in view on demand. But that is not how the tooling currently works and we find only crutches. This is cool paradigm that could make amazing startup. Add in some LLM for buzzword to hook investors. And actually LLM that can trawl all the current sources of knowledge and spitting a one paragraph to glance what and why is going on could even work. But we can't do it while constraining to text files. We need the equivalent of hypertext for code ... and it will be mess in the end.