Comment by aogaili

3 hours ago

You missed the entire point of the post..the author is arguing docs in md are the src...

But we already have a folder for docs? It's called "docs". If the docs are the source code, that's fine, but that doesn't mean we have to move them into the source code folder. We already have somewhere to put them! The end goal should be for the source code folder to be in the .gitignore, same as you would with object files... but if the docs are in there, now you're stuck.

  • Traditionally docs were for humans as a reference.

    This is not doc, this is an .md file as a src to be used by LLMs to generate code. Therefore they are src files but in english.