bcgov / bcgov/api-guidelines

Separate process and design principles

未关闭
#6 1 条评论 1 个 reaction 已指派 0 人 在 GitHub 查看
feedback
主要语言
没有语言数据
星标
34
派生
10
PR 合并指标
30 天内没有已合并 PR

描述

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.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。