Documentation is out of date, incomplete (tracking)
Open, NormalPublic


Our docs are teh suck. Fix them up.

This tracking bug has been superseded by the Documentation project tag.
Please use the Documentation tag on tasks instead of making tasks block T2001.

(Previous discussion: T85485)

Version: unspecified
Severity: normal



Related Objects

Task graph too large to display (this task is directly connected to more than 100 other tasks). Use Search... to explore connected tasks.
There are a very large number of changes, so older changes are hidden. Show Older Changes
Quiddity added a subscriber: Quiddity.EditedFeb 14 2015, 7:08 PM

I agree with yuvipanda. I think it is good to leave it 'open' as a symbol or meme or monument. People link to it more for the title ("Documentation is out of date, incomplete") than anything else. It's an iconic reminder. It's a forever unreachable goal, like the WMF Vision statement, that we are nevertheless always working towards.

It's a moment of levity, in an otherwise Serious Business world. It's a friendly/informal way of reminding each other, "dude, your documentation sucks" - instead we can say "oh, you might want to work on bug#(200)1 a little bit :) ". It's the best kind of 'inside joke', because newcomers can quickly figure out what is meant.

Practically/pragmatically speaking, I think it should be retired as an active *tracker* of any kind (to avoid confusion, and to avoid yuvi spending time writing a bot). [edit to highlight] But it's the one task that was never intended to be 'closed'.

to misquote: "there are three hard things in computer science: cache invalidation, naming things, up-to-date documentation, and off-by-one errors."

Legoktm updated the task description. (Show Details)Feb 14 2015, 7:12 PM
Dzahn added a subscriber: Dzahn.Mar 20 2015, 10:04 PM

there used to be the string "Reference to bz1" in this page until last week. i know because our watchmouse monitoring checks for that and is now not working anymore (T93443).

Dzahn removed a subscriber: Dzahn.May 29 2015, 1:29 AM
Qgil removed a subscriber: Qgil.Oct 11 2015, 8:29 PM
HappyDog removed a subscriber: HappyDog.Oct 12 2015, 8:56 PM
555 removed a subscriber: 555.Jan 30 2016, 2:58 AM
Meno25 removed a subscriber: Meno25.Feb 22 2016, 5:50 PM
Danny_B moved this task from Tag to Transition in progress on the Tracking board.Jul 10 2016, 10:39 PM
Paladox added a subscriber: Paladox.Jun 9 2017, 8:37 PM