“Project Insights” are a blessing for new Devs..

But Jira isn’t where you should keep it all..

Once tickets are closed, moved, changed, edited, reassigned, tied to different story it becomes impossible for someone new to extract insights off them.

From what I’ve seen most projects don’t really have a central place to keep insights, if they do, they get outdated very, very quickly!

Personally I keep a “http://spec.md” file in my project that contains valuable info about the project or anything else that I couldn’t add in the code itself or as a comment.

I don’t bother keeping it “formatted” per say but you’ll definitely have some “aha” moments if you glance over it.

Another case for keeping your code clean but also making sure it has enough information within itself to give someone the understanding they need to navigate.

/* “comments” has entered the chat.. 😀 */

Download a free copy

Leave a comment

Your email address will not be published. Required fields are marked *