@@ -12,7 +12,8 @@ The DRI is responsible for communicating progress through these
12
12
lifecycle phases by:
13
13
14
14
- Updating the "Lifecycle" tag on the associated GitHub Epic.
15
- - Optionally, announcing the update in #epd-announce and #ohship.
15
+ - Optionally, announcing the update in ` #epd-announce ` and
16
+ ` #shipped-it ` .
16
17
17
18
## Internal Development
18
19
@@ -41,16 +42,16 @@ Before a project can move to Private Preview, it must:
41
42
- Cause stability issues for other parts of the system.
42
43
- Live behind a gated feature flag (disabled by default).
43
44
- Have basic tests live and running.
44
- - Have basic reference documentation live behind a {{< private-preview >}} flag.
45
+ - Have basic reference documentation live behind a ` {{< private-preview >}} ` flag.
45
46
- Have its GitHub epic status set to "Private Preview".
46
47
47
48
## Private Preview
48
49
49
50
The goal of Private Preview is to identify and address all of
50
51
the reasons why the solution might not work. To do this, the
51
52
DRI is responsible for getting the solution in front of relevant
52
- internal (e.g. DevEx ) and external (e.g. customers) testers.
53
- It is recommended to kick this off by posting to #epd-announce
53
+ internal (e.g. testing team, analytics team ) and external (e.g. customers) testers.
54
+ It is recommended to kick this off by posting to ` #epd-announce `
54
55
and asking for support on identifying testers. Customer-facing
55
56
teams such as field engineering are well-positioned to provide
56
57
guidance on external testers. If you're unsure how to proceed,
@@ -83,12 +84,12 @@ Before a project can move to Public Preview, it must:
83
84
- Have addressed all known stability issues.
84
85
- Have addressed all known limitations, except those that are explicitly out of scope.
85
86
- Support all known customer configurations, except those that are explicitly out of scope.
86
- - Have polished reference documentation published with a {{< private-preview >}} notice.
87
+ - Have polished reference documentation published with a ` {{< private-preview >}} ` notice.
87
88
88
89
To move a feature to Public Preview:
89
90
90
- - Update any documentation about the feature to use the {{< public-preview >}} notice.
91
- - Add a release note with a {{< public-preview >}} flag.
91
+ - Update any documentation about the feature to use the ` {{< public-preview >}} ` notice.
92
+ - Add a release note with a ` {{< public-preview >}} ` flag.
92
93
- Update the GitHub epic status to "Public Preview".
93
94
- Enable the feature flag in all environments.
94
95
@@ -113,7 +114,7 @@ Before a project can move to General Availability, it must:
113
114
114
115
To move a project to General Availability:
115
116
116
- - Remove the {{< public-preview >}} notice from the documentation.
117
+ - Remove the ` {{< public-preview >}} ` notice from the documentation.
117
118
- Write a blog post describing the project, or explicitly
118
119
justify why a blog post is not required.
119
120
- Write a release note announcing that the project is in General Availability.
0 commit comments