Documentation is really important especially these days since people may want to understand the logic behind your system. Even security tools like Debuggix need updated and correct markdown files in order to reduce false positives during security checks and give real issues.