This repository contains the Open Water Foundation (OWF) Python training materials, which provides guidance for using the Python programming language. The documentation is written for the layperson in order to encourage use of Python.
See the deployed OWF / Learn Python documentation.
The repository contains the following:
.github/ (Files specific to GitHub such as issue template)
.gitattributes (Typical Git configuration file)
.gitignore (Typical Git configuration file)
README.md (This file)
build-util/ (Useful scripts to view, build, and deploy documentation)
mkdocs-project/ (Typical MkDocs project for this documentation)
mkdocs.yml (MkDocs configuration file for website)
docs/ (Folder containing source Markdown and other files for website)
site/ (Folder created by MkDocs containing the static website - ignored using .gitignore)
The development environment for contributing to this project requires installation of Python, MkDocs, and Material MkDocs theme. Python 3 has been used for development. See the OWF / Learn MkDocs documentation for more information about MkDocs.
If the development environment is properly configured, edit and view content as follows:
- Edit content in the
mkdocs-project/docs
folder and updatemkdocs-project/mkdocs.yml
as appropriate. - Run the
build-util/run-mkdocs-serve-8000.sh
script (Linux) or equivalent. - View content in a web browser using URL
http://localhost:8000
.
The OWF Learn Python website content and examples are licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Contribute to the documentation as follows:
- Use GitHub repository issues to report minor issues.
- Use GitHub pull requests.
This repository is maintained by the Open Water Foundation.
The following release notes indicate the update history for documentation, with GitHub repository issue indicated, if applicable (links to issues via README.md are not cleanly supported by GitHub so use the repository issues page to find).
- 2020-01-09 [4] - reorganize into training sessions, lessons and reference topics
- 2017-10-21 [1] - switch to Material theme, update documentation based on experience.
- 2017-01-15 - initial version.