DEV Community

Discussion on: Fixing your Documentation Problem

 
mortoray profile image
edA‑qa mort‑ora‑y

I'm quite undecided. On most projects that had architecture docs, I was the person to write them. I never referred to them again, nor did anybody else.

I can see them being helpful should I disappear from a project, but I'm not convinced they are essential. They also take time, which is time not spent doing something else.

Thread Thread
 
nebojsac profile image
Nick Cinger

That's fair, I'd say it depends somewhat on the project. But also, fixing the knowledge silo is, long term, a thing worth doing for the project. That's an extra point I could add to the subject, thanks for that :)

Thread Thread
 
nestedsoftware profile image
Nested Software

I was the person to write them

Found the problem! Hehe ;)