Ask HN: How to manage legacy knowledge and experts

1 points by vermooten ↗ HN
I work at an enterprise software house, where we have two old (20+ year) applications that are making us shit-tons of money despite the spaghetti code that has developed over the years.

We have around 5 developers who have been with use for 10+ years who know everything there is to know about it. It's very buggy of course, and we have a substantial 3-layer support team.

The problem is that, although there is lots of documentation, it gets out-of-date quickly and doesn't actually define the system or how to fix problems. So the 5 experts are needed so that he newbies can have a chance of addressing issues within the SLAs. Without these 5, we are screwed.

If they chose, they could hold us to ransom. they are excellent, professional individuals who wouldn't do this .. but there is a risk.

We COULD have those guys spend 6 months documenting the code, and what it's supposed to do. We COULD get them to set out structured training for new recruits .. .but these 5 are developers not trainers.

Are there any companies that provide expert consultancy for this kind of thing? A company who would come in and tell us how to do this effectively? If there aren't any then I'm totally going to set one up.

1 comment

[ 3.6 ms ] story [ 14.0 ms ] thread
I wouldn't call them legacy if they are a money maker of your core business. 1. when you change the code you should be updating the documentation. 2. you should have a system that documents support tickets and the solutions when you have production problems 3. if you know where the buggiest code is by number of production problems you can focus on re-factoring that part of the system. 4. make sure your experts know that part of they're yearly objectives(raises) is training and mentoring. Part of your job descriptions for senior level people should be about sharing knowledge and mentoring.