This repo holds the data sources for Zitec's Technology Radars (adapted by us and based on the original Thoughtworks Technology Radar).
All you have to do in order to update one of the radars is to find the corresponding file and edit it according to the instructions.
Please make sure that the file is not broken by the edits. Although you can check the outcome using the steps in the publishing section below, please also validate the file locally before pushing it to the repo.
Data for each radar is pulled automatically from a public Zitec GitHub repo.
To publish a radar, just edit the files and push the changes to the dedicated GitLab repository. This private repo is then automatically synchronized with the public GitHub repo.
Finally, once the changes are synchornized (it can take up to 5 minutes) check the radar using one of these short links
To add a new radar:
- Create a new file in CSV or JSON format using the linked insturction for the respective format.
- Push the file to the private GitLab repo and wait for it to be synchronized to GitHub.
- Go to the Build Your Own Radar page and insert the URL of the raw file from GitHub (eg: https://raw.githubusercontent.com/zitec/Zitec-Tech-Radar/master/TechRadar.csv)
- Finally, build the radar, take the resulting URL and share it with any interested party.
- Optionally, you can generate a short URL (using the https://zit.ec domain) using https://rebrandly.com/. Please use the Tech Leads chat group to ask for support with this.
The tech radar is now available in JSON format, which can be used to display the radar in the Backstage platform.
The current version of the radar unifies the data sources for the Dev and QA radars. The JSON file is available here.
The radar is validated in Gitlab CI to ensure that the JSON file is correctly formatted.
To test the JSON file locally, follow these steps:
- Install Genie on your machine (
bash <(curl -fsSL https://zit.ec/genie)
). - Execute
gni install
if this is your first time running the project. - Execute
gni run validate
to validate the JSON file.