README.md

Glossary

This repository serves as the single source of truth for the Open Contracting Data Standard glossaries, which support the consistent use and translation of key terms. The glossaries are updated in Google Sheets, revision-controlled in this repository, and uploaded to Transifex, to be accessed by translators. For more information, see terminology.rst.

Usage

The update.py script uses the Google Sheets API to update the glossaries directory.

1. Install dependencies

Create and activate a virtual environment, then:

pip install google-api-python-client

2. Set-up authentication

• Enable the Google Sheets API for an account that has read access to the glossary spreadsheet
• Save the credentials.json file in this directory (it is ignored by git)

3. Update glossaries

python update.py

The first time you run the script, you may need to complete in-browser authentication.

4. Manually update Transifex glossaries

Create or update the glossaries on Transifex. Alternately, instead of uploading one CSV at a time, the spreadsheet's combined tab, downloaded as CSV, can be used for this.