CDSS / Learn Git

This documentation provides resources to learn how to to use the Git version control software and GitHub cloud-hosted version control, including how to install, configure, and use Git. The documentation is intended to provide Git and GitHub training to OpenCDSS developers who are creating, maintaining, and enhancing CDSS software, model datasets, documents, and other electronic files that benefit from version control.

This documentation has been written based on experience using Git and GitHub at the Open Water Foundation, and is initially focused on existing CDSS developers and users, many of whom likely do not have experience with Git and GitHub. Experienced Git/GitHub users will benefit from sections of this documentation that focus on OpenCDSS Git/GitHub conventions.

This page of the documentation includes the following sections:


How to Use this Documentation

The documentation is organized in order of basic to advanced topics, with the goal being to provide hands-on learning through a sequence of lessons.

This documentation is not intended to be a full reference for Git but focuses on important topics that will help CDSS developers understand important technical concepts and be successful with Git within the OpenCDSS environment. Readers of this documentation should seek to expand their skills with other resources, first-hand experience, and learning from others. Suggestions for this documentation can be submitted by following instructions on the GitHub repository web page.

The following main sections are included in this documentation:

Colorado's Decision Support Systems (CDSS) and OpenCDSS

Colorado's Decision Support Systems (CDSS, cdss.state.co.us) has been developed to answer important questions about Colorado's water resources. CDSS efforts are led by the Colorado Water Conservation Board (CWCB) and Colorado Division of Water Resources (DWR).

CDSS Website

Primary CDSS components include the StateCU consumptive use model, which estimates irrigation water requirements and other demands, and the StateMod water allocation model, which simulates river basins to support water resources planning. The software source code and model dataset files are important electronic assets that need to be properly maintained.

In late 2016, the Open Water Foundation began the effort to move CDSS software to open source licensing and establish open source software projects. This effort is called "OpenCDSS" and will result in a new paradigm for maintaining and enhancing CDSS resources. Best practices for OpenCDSS, such as using Git and GitHub for version control, are being implemented. This documentation is the result of such efforts.

Open Water Foundation

The Open Water Foundation (OWF, openwaterfoundation.org) is a 501(c)3 social enterprise nonprofit that focuses on developing and supporting open source software to make better decisions about water resources. OWF is providing technical resources and management to transition CDSS software to sustainable open source projects.

See also other OWF learning resources.

License

The licenses for CDSS resources are being determined as part of the OpenCDSS project.

Source Repository on GitHub

The source files for this documentation are maintained in a GitHub repository: cdss-learn-git. This repository may be moved to a State of Colorado GitHub account in the future.

This documentation is prepared using MkDocs. For full MkDocs documentation visit mkdocs.org.