diff --git a/aep/general/0205/aep.md.j2 b/aep/general/0205/aep.md.j2 deleted file mode 100644 index d5049849..00000000 --- a/aep/general/0205/aep.md.j2 +++ /dev/null @@ -1,47 +0,0 @@ -# Beta-blocking changes - -APIs often release an alpha version of their API in order to get early feedback -from customers. This API is provisional and can change many times before the -important feedback is incorporated and the API is made stable for beta. - -Since the purpose of alpha is to gather feedback, the API does not need to be -perfect yet, and it's not strictly necessary for API authors to address every -usability concern or address every point in the API standards. Often, API -authors and API reviewers will not agree on the best design, and the best way -to find out is by having users try out the API. - -However, once the feedback has been collected and the API is going to be -promoted to beta, usability concerns and style issues need to be addressed. In -order to ensure that these issues are not forgotten, they **should** be -explicitly documented in the API. - -## Guidance - -If an API has usability concerns or violates API standards, and the present -design should receive additional scrutiny before being carried through to the -beta version, there **must** be an internal comment linking to this document -using its descriptive link ([aep.dev/beta-blocker]()) to ensure that the design -is corrected before the API is released to beta. - -The comment **must** also indicate what kind of change should be made for beta. -For example: - -{% tab proto %} - -```proto -message InputConfig { - // Parameters for input. - // (-- aep.dev/beta-blocker: Convert well-known parameters into explicit - // fields before the beta launch. --) - map parameters = 1; -} -``` - -{% tab oas %} - -**Note:** OAS example not yet written. - -{% endtabs %} - -If an exception to API standards _does_ need to be carried through to beta and -GA, see AEP-200. diff --git a/aep/general/0205/aep.yaml b/aep/general/0205/aep.yaml deleted file mode 100644 index 43fcc188..00000000 --- a/aep/general/0205/aep.yaml +++ /dev/null @@ -1,8 +0,0 @@ ---- -id: 205 -state: approved -slug: beta-blocking-changes -created: 2024-03-14 -placement: - category: governance -redirect_from: /beta-blocker