DEV Community

Discussion on: How do you document new "coding patterns" for your team?

 
tmr232 profile image
Tamir Bahar

But what do you do when you find them, if the link is already dead?

Thread Thread
 
ben profile image
Ben Halpern

Well at that point I feel like it's like a failed test. Somebody has to go deal with it and replace the link or remove it. The analyzer's job was only to flag it. This isn't to say that this marries well with the GitHub Wiki as the destination, but that's how these two things would combine.

Another possibility altogether, could be to have documentation actually hosted within code or something and you could verify presence and possible correction the way you would test code. Given sufficient abstraction, this is not too different from verifying 404s though I think.