Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Documenting code when leaving a company [closed]

I resigned from my current place of work yesterday, and I'm taking it upon myself to document my projects so I can hand them over easily.

Bearing in mind that my code is already commented to a good standard, what else should I put together to help my fellow developers take over my projects?

like image 416
djdd87 Avatar asked Jun 23 '09 06:06

djdd87


2 Answers

When working with a new code written by someone else, the first thing that the new guy (or girl) lacks is an overview over the System. What subsystems are there, what's their purpose and where should one look to accomplish a given task at hand are some questions that come to mind.

A concise starting document, explaining the overall system design (and the reasons why this design was chosen) perhaps with some diagrams, would be something I would be really glad to get when working on a piece of software written by someone else.

like image 119
Michael Klement Avatar answered Sep 19 '22 23:09

Michael Klement


Consider making your top-level overview documentation a Wiki - it allows your soon-to-be ex-colleagues to edit and expand it easily.

And a rationale (as mentioned) is very useful: Why did you choose solution A, when solutions B and C look so much better to a casual observer? It can nip all kinds of endless discussions in the bud.

like image 20
Harald Hansen Avatar answered Sep 18 '22 23:09

Harald Hansen