• About
        • About
          • Overview
          • What to Expect
          • Careers
          • Team
          • CANDO Culture
          • FAQ
        • Praxent Pricing Guide

          To give you an idea of what investment looks like we've created a guide with estimates by product type as well as set-priced starter engagements.

          Download Now
  • Industries
        • Industries
          • Fintech
          • Insurance
          • Lending
          • Wealth Management
          • Real Estate
          • Other
        • Praxent Pricing Guide

          To give you an idea of what investment looks like we've created a guide with estimates by product type as well as set-priced starter engagements.

          Download Now
  • Services
    • Design
      • User Experience Design
      • Customer Journey Mapping
      • Design Sprints
      • UX Audit
      • User Testing
      • User Research
    • Development
      • Custom Software Development
      • Application Modernization
      • Mobile App Development
      • Web App Development
      • Web Portal Development
      • Front End Development
      • Backend Development
      • Cloud Deployment
      • Implementations
      • Staff Augmentation
  • Case Studies
  • Insights
  • Schedule a Call
  • About
    • About
    • Overview
    • Careers
    • CANDO Culture
    • What to Expect
    • Team
    • FAQ
    • #
  • Industries
    • Industries
    • Fintech
    • Insurance
    • Lending
    • Wealth Management
    • Real Estate
    • Other
    • #
  • Services
    • Services
    • Design
      • User Experience Design
      • Customer Journey Mapping
      • Design Sprints
      • UX Audit
      • User Research
      • User Testing
    • Development
      • Custom Software Development
      • Application Modernization
      • Mobile App Development
      • Web App Development
      • Web Portal Development
      • Frontend Development
      • Backend Development
      • Cloud Deployment
      • Implementations
      • Staff Augmentation
    • #
  • Case Studies
  • Insights
  • Contact

Speak with an expert

(512) 553-6830
Close menu

Topics

  • Uncategorized
  • Development
  • Life at Praxent
  • Project Management
  • Strategy
  • UX & Design
  • Tech & Business News
  • Mobile
  • Product Management
  • Featured
  • Financial Services Innovators
  • Awards
  • UX Insights

Types

  • article Article
  • podcastpodcast
  • presspress
  • webinarwebinar
  • whitepaperwhitepaper

Code Documentation: How To Create Effective Handover Documentation

Get our development team’s tips for documenting and completing a software handover involving custom code.


Custom code refers to code which is specially tailored, or customized. This could be code linking two applications or systems, or code used for a proprietary software application. Since custom code modifies a standard code base, it is not universal to all developers.

Software Handovers

During some development projects, there are times when code needs to be transferred from one person to the next. A knowledge transfer for software may occur when:

  • Someone new joins the team
  • A developer transitions off one project to work on another
  • Someone leaves the organization
  • A project is transferred from one agency to another (rare instances)

In any of these scenarios, the developer working on the project needs to complete a software handover and pass along their custom code base to the new developer. While this sounds straightforward, if working with a custom code base it becomes more complex and it’s essential to create thorough and organized documentation.

How To Transfer Code (& Knowledge) Effectively

A standard part of any handoff from one developer to another includes documenting details about the code base they created. These details provide context, insight into how the code was written, and other important details.

Handover Documentation: What To Capture

Documentation is hugely important when it comes to transferring knowledge and code base. Code handover documentation usually includes three distinct sections, targeted at various audiences interacting with a project.

User Support: Documents written for any non-devs who interact with users of the app. This is typically troubleshooting steps that the CSR can take before escalating it to whoever the new devs are.

QA Workflow: Documents meant for anyone who can QA the app before an official release occurs.

Technical Documents: Super technical documents intended for other developers only. These developer-to-developer documents are what this post focuses on.

There are some key things to capture when creating technical documentation:

  • System Architecture
  • Code Base Organization
  • Source Code Commits
  • Database Schemas
  • Source/Version Control Procedures
  • Key Source Code Sections
  • Coding Standards

Code Documentation: 6 Things To Include

Beyond the categories listed above, there are some specific details we recommend including in any code documentation endeavor. The list below can be thought of as a software knowledge transfer checklist to run through when determining what to include.

  1. “_Deprecated” Folder: Include a folder or a section in your notes with historical information, so it’s not lost in the event it’s needed in the future.
  2. Simple Steps: Include instructions with very simple steps on how exactly to push a new release of the code.
  3. High-Level View: Provide an architecture overview document with a high-level view of the application.
  4. Risks: Provide Current Risks with Architecture document. This is extremely important so the new dev doesn’t inadvertently make a catastrophic mistake that can occur with the setup.
  5. Manual Processes: Include steps for anything that is a manual process, such as pulling reports
  6. Bugs: Include a dev-specific set of documents for troubleshooting common or known bugs.

When planning for a handover of software, a month is an ideal timeframe to allow for the transition. The first two weeks can be spent on training and writing documentations, and the second two weeks can be spent in transition with the initial developer available for any questions or support.


Legacy software is an asset, but only if you know how to leverage it.

>> Download our free CodePath Assessment e-book for evaluating the health of legacy software assets so you can innovate risk-free.


DIGITAL STRATEGY + DESIGN

  • Design Sprint Agency
  • Innovation Consulting Firms
  • Software Product Development
  • UI Consulting
  • User Experience Research Firm
  • User Experience Design Company
CUSTOM SOFTWARE DEVELOPMENT

  • Web Application Development Company
  • Insurance Software Services
  • Application Modernization Services
  • B2B Portal Development
  • Mobile App Development Company Texas
  • Custom Software Development Services
TECHNOLOGIES + TOOLS

  • Java Development Services
  • Custom Cms Development Services
  • Agile Management Services
  • .NET App Development Company
  • Ruby On Rails Development Team
  • Software Prototyping
  • Python Software Development Services

Leave a Reply Cancel reply

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

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Featured

What the Kardashians can teach your FI about fintech partners to identify niche markets.

What the Kardashians can teach your FI about fintech partners to identify niche markets.

Read more

The 4 Reasons Software Modernizations Fail (and 12 Strategies for Success)

The 4 Reasons Software Modernizations Fail (and 12 Strategies for Success)

We share the strategies you’ll need to modernize your online customer experience so you can outperform your competitor...Read more

Making Sense of User Research: 5 Tools for Finding & Refining Winning Product Ideas (Plus Free Templates)

Making Sense of User Research: 5 Tools for Finding & Refining Winning Product Ideas (Plus Free Templates)

Making Sense of User Research: 5 Tools for Finding & Refining Winning Product Ideas Collecting quality data about … Read More

Many companies have built software applications that no longer meet customer expectations. We help financial services companies modernize those applications so they can remain relevant against born-digital competitors.

4330 Gaines Ranch Loop, Suite 230
Austin, TX 78735

(512) 553-6830

hello@praxent.com

DESIGN
  • UX Design
  • Design Sprints
  • User Research
  • User Testing
DEVELOP
  • Custom Software
  • Web Portals
  • App Modernization
  • Web Apps
  • Mobile Apps
ABOUT
  • Case Studies
  • Team
  • Culture
  • Careers
  • Insights
  • Contact

© 2023 Praxent
Privacy Terms Site Map