Linkrot is not just a problem in Wikipedia or any other site with links to other sites but in documenation that link can mean understanding how to use a piece of software or not. One thing I have noticed myself and reported a few bugs on is when upstream moves to a new hosting site sometimes there are links left to a dead project that isn't used anymore. If you want to fight this kind of link rot which lists the packages homepage I find synaptic package manager with the click to the project homepage and being able to scroll down even though it is old and have even done submitted a few simple patches to upstream so everyone gets the correct upstream link. Also more places will move with the coming googlecode shutdown but at least these seem to redirect to the new sites. I also find linkrot in wikis and often new features or really useful features don't get added. It does not take someone that long to make links work on a wiki but the hard part is testing the links. With moinmoin on ubuntu community wiki or ubuntu wiki one crucial thing I remember that frustrates me is remembering when pressing preview to open the link in a new tab as not to hit preview check the links works then lose my edit.
Checking links isn't overly difficult
- Acutally needing to check that documentation works is important because someone might be struggling with a piece of software and then finding the link doesn't work adds another layer to problems to users that may be a little upset. Even if you think you know how to use a program you may find out features you did not know where there by reading documentation however the true cost of this is what else you could be doing with this time. Even for the silly command line program cowsay, which prints a picture of a cow saying some text, has value from actually reading the manpage.
http://manpages.ubuntu.com/manpages/vivid/en/man6/cowsay.6.html There is the silly -e option which allows to change out the eyes. After seeing this option I wondered what other characters could make silly eyeballs for the cow. I ended up liking ⏣⏣ as characters for the eyes of cows. I ended up running this command several times but remembered it was called benzene ring with circle and the characters ⏣⏣ make silly eyes for a cow. I ended up wanting to make this silly command again so I found that the search utility with the character map is quite useful. Today I ended up looking at the page on the community wiki for the character map and it seems like it needs improvement. Also notibly the search feature and viewing by unicode block were not mentioned by this application yet they are some of the most useufl features of being able to copy the characters to any application and that it had not been updated for almost 6 years yet this application ships in most flavors of ubuntu. I added some lines documenting the critical search and alternate sorting if you don't know the exact name of a math symbol but know what it looks like but this still needs some work. Searching for symbols makes more sense than blindly going through every symbol in fonts in utf8.
although thinking back it quite ironic I wasn't using this for anything serious but found gucharmap much more useful once I new about the search feature.
The irony is I was not trying to do anything useful and was a little bored. The search can be espicially useful yet was not documented in this wiki page and had never been so. I think this is key functionality on a page that hadn't been edited in several years and yet the things that tought me about this was as silly a program as cowsay. That is not to say I made the page for the character map perfect it really could use anew screenshot and maybe talk about launching it from unity with the dash. The second feature of the character map I like is sort by unicode block to find like all math symbols if you can't quite remember the name but know what the symbol looks like.
More help on documentation is needed
I also found a few other links that I pointed to thinks that should work now to stop the linkrot and new features and things get forgotten. I have one clear expirence of a youtube review of lubuntu did not have the shortcuts of super plus an arrow key to snap a window to that half of the screen documented until I took the initiative to fix it actually had a favorable review of lubuntu list not have this a problem in quidsup review of 14.04 on youtube. Someone corrected him in a comment and in his next review he corrected this statement. However as I saw this I knew about the feature but I looked back to the wiki page where keyboard shortcuts on lubuntu are documented as https://help.ubuntu.com/community/Lubuntu/Keyboard and noticied this shortcut was missing. I ended up asking the team lead for wiki and docs at the time and added it in as it makes sense. The lesson here is people may not know about features that help them get their work done and will help with adoption if you do not document them. Even people that like any flavor could end up not promoting as much because they don't know every feature which in turn could lead to a cycle of more contributors and users if they have a good expirence. As a more knowledgeable user I should go back and look at documenation as it is not that easy for new people and also keep in mind what is easy for you may not be easy for soemone else.