The portals repository should have technical documentation for all aspects of the architecture, workflow and deployment process. This documentation should be aimed at developers and live in the repository itself, for easy reference while developing. It can be formatted as markdown so that it is easily readable on the github and diffusion repository clones, like the 'readme' file is.