Knowledge base and transfer

Photo by Scott Graham on Unsplash

Knowledge bases are important for teams. They help teams to document the history, current state and planned future of software products and services.

Ideally knowledge bases are maintained in collaboration platforms (eg: SharePoint, Confluence). They are ideally online, searchable and well maintained.

Very often knowledge bases are outdated and not kept uptodate. This is because teams rarely have documentation in their checklist (Scrum: Definition of Done) before marking a task as Done.

This results in a technical debt that is coming back to catch you when you really need it. For example, when a team member leaves, a knowledge transfer needs to happen.

  1. The knowledge transfer would be easy if a knowledge base existed and is constantly kept uptodate.
  2. The knowledge transfer would be easy if every task follows the two person rule (or four eyes principle).
  3. Every active product or service has a technical documentation with setup, configuration, changes and support
  4. Every active product or service has a user manual with usage scenarios and expectations

Now let us see how we can make the above things part of our daily routine.

Step 1:

Every task completed by the team is considered DONE only when two things are satisfied

  1. There is documentation for the product or service feature
  2. There is second person who read and approved of the documentation

Step 2:

Every product or service which goes to Production is considered DONE only when two things are satisfied

  1. There is technical documentation for developers on the team to support and extend it
  2. There is a user (friendly) manual for customers to be able to use the product or service

Even when the above two steps are complete when a person leaves a team a handover needs to be done. Here is a sample list of some of the items we check for handovers.

Handover checklist:

  • Project name
  • Project status (active, inactive)
  • People
  • Priority
  • Handover to (person)
  • Handover activities
  • Due date
  • Status (not started, in progress, completed)
  • Documentation links
  • Notes

Using the handover checklist a team can do a kickoff for the handover where all the projects that need a handover are identified. The important parts are being able to identify the People and the Handover to person.

If a project has only one person on the People, it is already a sign that the handover will be difficult. However with enough planning this can be remedied.

In the kickoff the Handover activities need not be detailed. This can be done between the person doing the handover and the person receiving the handover.

Depending on the priority and the time available the due dates may be timeboxed and a knowledge transfer may be done.

You have a Handover to be done?

With the knowledge base, two person rule, technical documentation and user manual you are ready to handle it with ease.


Having Audacity helps with Audio podcasts

I recently came across two cool features on Audacity which helped me improve my podcast episodes.


One is to amplify or normalize loudness of the recorded audio. If I have to reduce or increase my audio setting in my phone while listening to audio for songs or podcasts it irritates me. I wanted to not put my podcasts listeners through the same trouble and I came across LUFS.

LUFS!?! What?

Loudness, K-weighted, relative to full scale (LKFS) is a standard loudness measurement unit used for audio normalization in broadcast television systems and other video and music streaming services

I use Spotify for Podcasters to upload and put together audio episodes and they recommend a target LUFS of -14.

The nice thing is that Audacity supports Loudness Normalization as a standard feature. Just read the article on LUFS on the Audacity website and you have an audio normalized just right for Spotify (Loudness Normalization – Audacity Manual (


Second feature is to truncate silence when it is too long. I sometimes have a video episode that I convert to audio. A long pause in video works with visual input but does not in audio when the user is only listening and has no visual input.

The Audacity feature to truncate silence (Truncate Silence – Audacity Manual ( when it is too long really helps. I identified silent blocks longer that 1.5 seconds and reduced them to 1 second and you notice that it flows better for audio.


Ranjith Venkatesh Podcast on Google Podcasts: Ranjith Venkatesh @ Moss and Lichens (

Ranjith Venkatesh Podcast on Spotify Podcasts: Ranjith Venkatesh @ Moss and Lichens | Podcast on Spotify

Spotify for Podcasters: