Open Water Foundation / Learn MkDocs
This documentation provides resources to learn how to use the MkDocs software, which creates static documentation websites from Markdown source files. A static website can be viewed on a local computer and can be published to the web. Such documentation can be developed for software products such as developer and user documentation. Documentation can also be created for other projects where navigable documentation is desirable.
This documentation has been written based on experience using MkDocs at the Open Water Foundation.
The documentation that you are reading has itself been created with MkDocs.
About the Open Water Foundation
The Open Water Foundation is a nonprofit social enterprise that focuses on developing and supporting open source software for water resources, so that organizations can make better decisions about water. OWF also works to advance open data tools and implementation. OWF has created this documentation to educate its staff, collaborators, and clients that use MkDocs for documentation.
See also other OWF learning resources.
How to Use this Documentation
The documentation is organized in order of information and tasks necessary to setup a development environment and use MkDocs software. The menu on the left lists pages in the documentation. The menu on the right lists sections in this page. If the width of the page has been made narrow, the menus may display as icons with popup menus.
This documentation is not intended to be a full reference for MkDocs or Markdown but focuses on topics that will help understand important technical concepts and be successful with MkDocs. See the Resources section for general information about MkDocs.
License
The OWF Learn MkDocs website content and examples are licenses under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Source Repository on GitHub
The source files for this documentation are maintained in a GitHub repository: owf-learn-mkdocs.
Release Notes
See the Release Notes in the GitHub Project and GitHub repository issues.