bcgov / bcgov/api-guidelines

Separate process and design principles

Open
#6 1 comment 1 reaction 0 assignees View on GitHub
feedback
Dominant language
No language data
Stars
34
Forks
10
PR merge metrics
No merged PRs in 30d

Description

Thanks for this! I have a comment.

In the Principles section I read the following:

> API as a Product : apply the product owner role to API's

I think that development processes should be separated from design principles. Having a principle that implies that there should be a Product Owner looking at the API as a product excludes other Agile and traditional software development frameworks where there is no such roles. Consequently, it limits this principles to the Scrum framework. I don't think that design principles should be mixed with specific development processes. I would recommend to remove or rephrase the one mentioned above.

In a related note, in the Agile front, a self-organizing team can use the design principles to create high quality APIs, but the Product Owner should not need to have the technical background to understand them and prescribing them as backlog items. Product Owner focus more on vertical slices of functionality that deliver value to users. Product Owners should not need to focus on individual components of a solution.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.