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


There are a very large number of changes, so older changes are hidden. Show Older Changes
Aklapper closed this task as "Declined".Feb 14 2015, 2:03 PM
Aklapper claimed this task.
Aklapper added a subscriber: Aklapper.

@yuvipanda: Did you also volunteer to keep the two places which track the very same thing (both the 'documentation' tag and this tracking task) in sync? If not, who will spend the time to do that?
I don't think "I like to keep this open due to cultural reasons" is a convincing reason for intentional untidyness in an issue tracker. If you like to be reminded that our documentation is bad, feel free to save this search query for open documentation tickets and put it in your list queries.

yuvipanda reopened this task as "Open".Feb 14 2015, 2:45 PM

Sure, I can write a bot that can keep them in sync.

Qgil removed Aklapper as the assignee of this task.Feb 14 2015, 3:01 PM
Qgil added a subscriber: Qgil.
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 edited 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