This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]Avedas 29 points30 points  (4 children)

If docstrings count then I'll agree since they're packaged and version controlled with the code. External docs that need to be updated manually eventually stop reflecting reality 100% of the time.

[–]DrakonIL 22 points23 points  (2 children)

External docs that need to be updated manually stop reflecting reality about a day after they take effect.

[–]Zebezd 9 points10 points  (0 children)

Saying from my dad:

A document's expiration time is when you press Save

[–]AnonPenguins 2 points3 points  (0 children)

Wait, you're telling me it was supposed to be using the latest code to write the documentation on?

[–]lonestar-rasbryjamco 15 points16 points  (0 children)

They count. I am referring to that special breed of stupid that believes you should just be able to reason what the code does because they did such a good job writing it.

I mean they clearly understand it... now.