search

Azure / azure-sdk-tools

Tools repository leveraged by the Azure SDK team.
MIT License
114 stars 180 forks source link

Updates to APEX requirements and release plan docs #7558

Open ladonnaq opened 9 months ago

ladonnaq commented 9 months ago

Requirement: Update APEX requirement and release plan docs based on stakeholder and service partner feedback

Topics to be covered in revised docs

Common scenarios highlight progression from Beta to Stable SDKs 

### Tasks
- [x] Update all CLC APEX launch readiness requirement descriptions.  Word doc versions can be found here - https://microsoft-my.sharepoint.com/:f:/p/ladonnaquinn/EtleLFJfcPtHkVKmzCry4EQBQ0jdnHeqewuWgtqeNdzihg?e=vpvmDw
- [x] Release Planner Overview for data & management plane presentations - https://microsoft-my.sharepoint.com/:p:/p/ladonnaquinn/EbLiwHt9anBJrSSdyquA5uAB-KH2FcjVBfoeAJkYdzWnvw?e=wpg0AT & https://microsoft-my.sharepoint.com/:p:/p/ladonnaquinn/EfqXO1e8btpBtPD4R7G8hLAB5BX35ILcdQSMRQ3vGTuYaQ?e=5sM0tm
- [ ] Create and link to demos that cover Release Planner overview, data plane milestone overview for Public Preview, management plane milestone overview for Public Preview
- [x] Provide guidance on new initial vs new SDK versions requirements to help teams navigate the release plans until they are customized based on the scenario.  Diagrams are in the release planner overview presentations.
- [ ] Create example release plans in PPE for Private Preview
- [x] Create example release plans in PPE for Public Preview.  Mgmt - https://web.powerapps.com/apps/8ca4408d-6af3-475f-90fe-51b2e43624bb?release-plan-id=6e891c96-942d-ef11-840a-000d3a9cab13 & Data - https://web.powerapps.com/apps/8ca4408d-6af3-475f-90fe-51b2e43624bb?release-plan-id=c3bf1b04-cec9-ee11-9079-000d3a565aab
- [ ] Create example release plan in PPE for GA

 

Request from Catalinia based on service partner feedback: @catalinaperalta From: Catalina Peralta [Catalina.Peralta@microsoft.com](mailto:Catalina.Peralta@microsoft.com) Sent: Thursday, January 11, 2024 1:37:59 PM To: Justin Bettencourt [jbettencourt@microsoft.com](mailto:jbettencourt@microsoft.com); Mariana Rios Flores [mariari@microsoft.com](mailto:mariari@microsoft.com); LaDonna Quinn [ladonnaquinn@microsoft.com](mailto:ladonnaquinn@microsoft.com) Cc: Laurent Mazuel [lmazuel@microsoft.com](mailto:lmazuel@microsoft.com) Subject: Release planner feedback

Hi all,

I wanted to reach out with a suggestion that I think will help with Release Planner adoption. I’ve noticed that a few service teams seem to be reluctant to begin working with the release planner and usually their questions are related to what information/commitments will be expected of them once they create one. I think having documentation in engineering hub with a step by step tutorial with screenshots of each of the release plan pages would be helpful since some service partners would like to know beforehand what to expect from the app from start to finish. I have seen the diagram we currently have on the site, but I believe a step-by-step tutorial would be even more intuitive and would show service partners what information the app will request from them. This could additionally be done in a video format if we think that would be easier for some folks to learn how to use the release planner.

Here is a quote I got in email today from the Health Insights team about using the release planner: “Is there a tutorial regarding how to complete/use the planner ?”

It would also be good to emphasize that the app is meant to be used by both PMs and developers since I have found that to also be a point of confusion. Highlighting how this app helps/benefits each team member through the process would be helpful and we can start pointing folks to these specific documentation sections to encourage adoption and improve usage.

Let me know if you have any questions or if I can provide any more information. Thanks, Catalina

ladonnaq commented 6 months ago

Per the Design Team guidance, we should not have screenshots of the Release Planner App in our docs. As an alternative, the release plan page describing the steps in a milestone has been updated to direct to other docs pages for more information on the step. We can also include links to completed examples of release plans in the PPE environment.

Here are examples release plans. I will complete all of them and post links to engineering hub. Blocked by permissions for PPE tables (SDK release milestone namespace). Let engineering know and when resolved will complete task.

Private Preview release plan examples:

Public Preview release plan examples:

GA release plan examples:

ladonnaq commented 6 months ago

TODOs: Update release plans once permissions are fixed in PPE for table related to SDK namespace drop-down box. Private Preview release plan examples:

Public Preview release plan examples:

GA release plan examples:

Request engineering to mark all other release plans as abandoned.