Welcome

City of Boston’s Digital Team

We build digital experiences designed around the needs of our constituents. We work to make these tools beautiful, welcoming, and highly useful.

Getting started is where you’ll find general onboarding/high-level info about our team, the technologies we use, and how we work together.

Standards and best practices ensure that our code and workflows are consistent across the team.

Guides is a collection of how-tos and references for the technologies we work with. These should not project-specific.

If you were getting ready to contribute code to a project, “Standards and best practices” will give you information such as what your feature branch name should look like.“Guides” is where you’d find a walkthrough of how to make your pull request.

Projects is where general documentation for a specific project can be found (project-specific technical documentation is better suited for the project README). This section is primarily the domain of product managers. Private information is kept in Google Docs that are linked to from here. External resources is where to find links to useful information and tools.“Learning resources” are things like tutorials and guides. “Reference links” tend towards specs, references, and tools.