bcgov / bcgov/api-guidelines

From Dig Platforms & Data - policy perspective

Ouverte
#15 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub
feedback
Langage dominant
Aucune donnée de langage
Étoiles
34
Forks
10
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

Hi Ruonan,
Reviewing from a non-technical perspective, I have a few comments:
- Consider including a Definitions section, or adding a few defs within the document. I noted a few terms that may need a description to ensure the document is widely accessible: BC Data Catalogue, OAUTH token, CI/CD pipeline.
- "API Store" - suggest this term be replaced with "BC Government API Registry"
- open source software - a few tools are mentioned in the guide and, to ensure employees are aware of requirements for acquiring open source software, consider including a link to the [Guidelines on the Use of Open Source Software](https://www2.gov.bc.ca/assets/gov/government/services-for-government-and-broader-public-sector/information-technology-services/standards-files/guidelines_on_the_use_of_open_source_software_2016.pdf), and the [BC Open Source Development Employee Guide](https://github.com/bcgov/BC-Policy-Framework-For-GitHub/blob/master/BC-Open-Source-Development-Employee-Guide/README.md) for Github contributions. Also suggest consistently including hyperlinks to promoted tools (e.g."Postman" and "curl").

Thanks !
Julie

Guide de contribution

Ouvrir le guide de contribution

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.