Github

HOME » TECHNICAL DOCUMENTATION » GITHUB

PAPUA uses Github features and services to provide the service transparently. This includes the methodology used to create the service - we want to make sure our processes are clear and can be used by other USDR or government projects to quickly bootstrap similar services.

Wiki

This wiki exists to provide broader information in greater detail than is appropriate for a readme. It also serves to keep information accessible - early project documents were stored in a private Google Drive, making it more difficult share or provide access after the fact.

Pages

Though PAPUA was designed to be entirely maintained and deployed via AWS Amplify, we received a request when working with New Jersey to enable hosting from Github Pages. This enabled NJ to quickly reconfigure and deploy the form (without the backend services). You can check out the Pages-hosted demo version here.

Project Boards

Project Boards enable us to publicly track work. We create issues that represent tasks that can be completed by one person in a reasonable amount of time (less than a day). These issues are assigned to the person working on them, are labeled to provide more context on how they fit into the larger project, and move across a kanban-style board to represent their status. See the below sections for more details on this process.

The board is discussed with the broader team at a regular cadence to make sure the tasks align with the work being done.

Issues

Issues can be used in a number of ways that facilitate collaborative work. PAPUA uses them to track individual tasks, open questions that need to be discussed or to communicate code fixes like bugs. Issues automatically populate our project board, minimizing project management overhead and reducing duplicating communication across multiple platforms (email, chat, meetings etc)