TTS offices and programs — including 18F, Centers of Excellence (CoE), Presidential Innovation Fellows (PIF), and Solutions — promote team best practices across specialty areas through guilds. These guilds support their members in whatever way deemed most appropriate by those members themselves.
This repo is where the TTS Engineering Practices Guild keeps its guide to best practices and resources for software development. Documentation is written using Markdown syntax and published as HTML using the Jekyll static site generator.
- Published guide: engineering.18f.gov
- Raw content: _guide/_pages
- CONTRIBUTING.md on how to build this guide locally and submitting PRs/issues.
We believe that government-developed software products should be functional, maintainable, and thoughtfully designed. Our guild helps TTS promote the adoption and advancement of software engineering best practices. In this way, TTS can lead by example while providing effective services that help our partners and customers fulfill their missions. To achieve our vision, the Engineering Practices Guild works to:
- Support the continuous learning necessary for successful software engineering work.
- Provide TTS developers with easy-to-understand, actionable guidance around software engineering best practices.
- Promote a central knowledge base of shared tools, common patterns, tutorials, and exemplary source code repositories, to help build technical capacity at our partner agencies so that they might better govern their software development efforts.
- Create a robust and supportive internal environment so that we can, in turn, bolster healthy external communities related to our work.
We use issues in this repo to track work. If you'd like to suggest a new topic or flag an issue, please file an issue.
The software development industry is ever-changing, and our guide is a living document. Please suggest edits or changes via pull request.
This site uses the 18F/isildurs-bane template, which manges all the content outside of _guide directory. Submit pull requests against that repository to effect those files. Only files under _guide should be modified and maintained here.
To run the site locally, we recommend using:
gitdockeranddocker-compose(included in Docker Desktop)
-
Clone the repository:
git clone https://github.com/18F/development-guide.git
-
From within the repository directory, run:
docker-compose up --build
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.