| description |
|---|
Standards we follow as developers. |
- All new software is checked in to GitHub.
- Legacy software that needs maintenance gets moved to GitHub.
- Absent a very compelling reason, repos are public from day one and source code is released under the CC0-1.0 public domain license.
{% page-ref page="git-and-github/" %}
{% tabs %}
{% tab title="Web applications" %}
We’ve moved to a monorepo structure, and use Lerna to manage it. This repository can be found at https://github.com/CityOfBoston/digital/. develop is its main branch and is only updated by pull request/merge, never by committing directly.
All new webapps should be created under /services-js. Our internal modules are found at /modules-js. We are working on migrating older apps into the monorepo over time.
{% endtab %}
{% tab title="Drupal" %}
{% endtab %} {% endtabs %}
{% tabs %} {% tab title="Web applications" %}
- Use Yarn instead of NPM when installing packages, so we can take advantage of workspaces.
- Set up your editor to automatically run Prettier on save. See the guides: https://prettier.io/docs/en/editors.html.
- Create Storybook stories to provide documentation for your components, and to allow for visual regression testing with Percy. {% endtab %}
{% tab title="Drupal" %} Set up automatic linting with PHPUnit [???]
DoIT use a set of PHPUnit driven linting tests to check coding standards are being met. Local Testing - Linting tests can be run locally by developers using lint utilities in their development environments. Developers can also execute a mirror of the tests run during CI (by Travis) using Phing tasks locally. {% endtab %} {% endtabs %}
Boston.gov subdomains are assigned on a case-by-case basis. Typically, anything that is a core city service will qualify for a subdomain.
If the website qualifies for a subdomain, it should adhere to the following conventions:
- Example: https://mayors24.cityofboston.gov/ fulfills service requests for the Mayor’s 24
- Example: https://data.cityofboston.gov/ is the data hub for the City
- 100% Talent: The Boston Women’s Compact does not use talent.cityofboston.gov because “Talent” could be interpreted as “Employees”, thus misleading users who are searching for the Career Center.