Introduction

Purpose

Describes the Application Development and Support Directorate's standard for organising your software solution.

Scope

Software Developers have a responsibility to follow this guide.

Developers targeting frameworks other than .NET may need to make sensible adjustments where necessary.

References

• General Coding Standards

Conventions

This section follows the handbook-wide conventions for RFC 2119 key words and callout boxes.

Note that all links to Microsoft Learn© may default to Azure DevOps Services. Use its version selector to tailor the website for Azure DevOps Server.

The need for guidance

Modern programming practices expect us to prove that our code meets functional requirements and can be reliably built and deployed.

This requires a little forethought when creating a solution that others will use (often without the originating developer present.) So, it's critical we create software solutions that are:

• Clear and explicit

• Understandable by developers of all abilities

• Safely extensible & well documented

The following sections provide guidance on how we can achieve this.