Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added a bit of back ground reason d'etre and a child page display

These pages are the start of a brain-dump on good (I think?) documentation practices.

Ideally the rest of the team should add, modify, comment etc on these documents as I’ve definitely missed information and got some stuff wrong.

Pages

Readme and Architecture

Code Comments

Pull Requestsrepresent good practice guidelines for and aims to cover all the main areas of software development. The purpose of this is to ensure that what is produced does not require the author to explain things but rather that the documentation includes enough detail that a renal registry developer can understand and progress projects developed by others. 

As always with documentation what is obvious to one person may not be for someone else so it is always important to ensure documentation is tested by users who don't necessarily have a priori knowledge of the subject. When gaps are found in the documentation by a user they should always add the extra information required.  

Child pages (Children Display)
sorttitle