diff --git a/docs/grid_release_procedures.md b/docs/grid_release_procedures.md new file mode 100644 index 0000000..95da681 --- /dev/null +++ b/docs/grid_release_procedures.md @@ -0,0 +1,92 @@ +

Grid Release Procedures

+ +

Table of Contents

+ +- [Introduction](#introduction) +- [Grid Release Goals](#grid-release-goals) +- [Grid Release Timeline](#grid-release-timeline) +- [Story Metadata](#story-metadata) + - [Grid Release and Stories ETA](#grid-release-and-stories-eta) + - [Owner and Executor](#owner-and-executor) + - [Project](#project) + - [Labels](#labels) + - [Stories Status](#stories-status) + - [Moved or Updated](#moved-or-updated) +- [Story Template](#story-template) + +--- + +## Introduction + +We provide the overall procedures for optimal grid release. + +## Grid Release Goals + +- A grid release is well accomplished if: + - It has clear specs defined at the beginning of the project + - The specs are turned into clear stories filled with proper information + - Stories are completed within the given ETA and stakeholders confirm the work done + - Each story has an owner and an executor (can be the same person) + +## Grid Release Timeline + +Each grid release has a timeline, [see this document](grid_release_timeline.md). + +## Story Metadata + +Metadatas should be completed for each story to facilitate tracking and realization. The important metadata are: due date, project, label and assignees. + +### Grid Release and Stories ETA + +- Each story has a clear ETA set as Due Date in gitea metadata +- Each grid release has a clear ETA set as Due Date in gitea metada + - This is done in the Grid Release Timeline story + +### Owner and Executor + +- Each story has an owner, someone who makes sure the story is completed, and an executor, someone who executes the story +- Owner and executor can be the same person + +- The people assigned as Assignees are the Owners of the story + - The owners need to make sure people do the work and that there are executable issues on GitHub or on Gitea + +### Project + +- Each story should be within a given project (e.g. 3.16) + +### Labels + +- Each story should be labelled as Story + +### Stories Status + +Stories have status defined by their position on the project kanban. There are 5 columns: + +- To Define + - Stakeholders need to discuss the story and complete the info (e.g. ETA, Owners, Assignees, etc.) +- To Do + - A story has been defined and has not yet been started +- In Progress + - A story being worked on +- Blocked + - If it is blocked, stakeholders must make sure it gets fixed + - If stakeholders can't fix it, it must be escalated to Kristof +- Done + - Once a story is completed, it's closed + +### Moved or Updated + +Also, a story can be moved or updated. + +- Moved + - We can define that the story is better for a future release, so we move it + - Moved story should maintain info related to original issues (e.g. google docs link) +- Updated + - If a story is updated, it must be done with the approval of all stakeholders + +## Story Template + +- Each story should follow a basic template to make sure they all satisfy the project goals. + - [Engineering Circle Story Template](https://git.ourworld.tf/tfgrid/circle_engineering/issues/new?template=.gitea%2fissue_template%2fstory_template.md) + + diff --git a/docs/grid_release_timeline.md b/docs/grid_release_timeline.md new file mode 100644 index 0000000..d5415e0 --- /dev/null +++ b/docs/grid_release_timeline.md @@ -0,0 +1,31 @@ +# Grid Release Timeline + +## Introduction + +Each grid release follows a clearly defined timeline. This ensures all the tasks are done properly. + +## Template + +Each grid release should have in its project kanban one issue containing the template below, adjusted with the current grid release. + +``` +# X.YZ Grid Release Timeline + +We provide the overall guideline for X.YZ grid release. Making sure all those steps are done in order will ensure the grid release is done efficiently. + +- [ ] Stakeholders meet and define the grid release specs +- [ ] Specs are turned into stories in a grid release project kanban +- [ ] Stakeholders confirm the stories as fulfilling the specs and grid release goals (with Grid+stories ETA) + - Make sure not to add stories in the middle of the sprint + - If there is a need, it needs to be agreed upon +- [ ] Comms circles write a forum post explaining the specs of the grid release, preparing community members to the grid release GEP +- [ ] Stories are worked on and completed +- When a grid release project is completed (all stories are completed) + - [ ] Stakeholders meet and review the stories, confirming they are correctly done + - [ ] A post summarizing the GEP is posted on the forum, written by Ops (Sabrina) +- [ ] When the GEP is passed, devs and ops implement the new features of the grid (e.g. publish to all networks) +- [ ] Comms circle communicate with the community that the grid release is done + +``` + +For an example, see the 3.16 version [here](https://git.ourworld.tf/tfgrid/circle_engineering/issues/126). \ No newline at end of file diff --git a/meetings_notes/engineering_meeting_24-03-10.md b/meetings/2024/engineering_meeting_24-03-10.md similarity index 100% rename from meetings_notes/engineering_meeting_24-03-10.md rename to meetings/2024/engineering_meeting_24-03-10.md diff --git a/meetings_notes/engineering_meeting_24-08-07.md b/meetings/2024/engineering_meeting_24-08-07.md similarity index 100% rename from meetings_notes/engineering_meeting_24-08-07.md rename to meetings/2024/engineering_meeting_24-08-07.md diff --git a/meetings_notes/engineering_meeting_24-08-12.md b/meetings/2024/engineering_meeting_24-08-12.md similarity index 100% rename from meetings_notes/engineering_meeting_24-08-12.md rename to meetings/2024/engineering_meeting_24-08-12.md diff --git a/meetings_notes/engineering_meeting_24-08-29.md b/meetings/2024/engineering_meeting_24-08-29.md similarity index 100% rename from meetings_notes/engineering_meeting_24-08-29.md rename to meetings/2024/engineering_meeting_24-08-29.md diff --git a/meetings_notes/engineering_meeting_24-09-02.md b/meetings/2024/engineering_meeting_24-09-02.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-02.md rename to meetings/2024/engineering_meeting_24-09-02.md diff --git a/meetings_notes/engineering_meeting_24-09-09.md b/meetings/2024/engineering_meeting_24-09-09.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-09.md rename to meetings/2024/engineering_meeting_24-09-09.md diff --git a/meetings_notes/engineering_meeting_24-09-12.md b/meetings/2024/engineering_meeting_24-09-12.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-12.md rename to meetings/2024/engineering_meeting_24-09-12.md diff --git a/meetings_notes/engineering_meeting_24-09-16.md b/meetings/2024/engineering_meeting_24-09-16.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-16.md rename to meetings/2024/engineering_meeting_24-09-16.md diff --git a/meetings_notes/engineering_meeting_24-09-23.md b/meetings/2024/engineering_meeting_24-09-23.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-23.md rename to meetings/2024/engineering_meeting_24-09-23.md diff --git a/meetings_notes/engineering_meeting_24-09-26.md b/meetings/2024/engineering_meeting_24-09-26.md similarity index 100% rename from meetings_notes/engineering_meeting_24-09-26.md rename to meetings/2024/engineering_meeting_24-09-26.md diff --git a/meetings_notes/engineering_meeting_24-10-07.md b/meetings/2024/engineering_meeting_24-10-07.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-07.md rename to meetings/2024/engineering_meeting_24-10-07.md diff --git a/meetings_notes/engineering_meeting_24-10-10.md b/meetings/2024/engineering_meeting_24-10-10.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-10.md rename to meetings/2024/engineering_meeting_24-10-10.md diff --git a/meetings_notes/engineering_meeting_24-10-14.md b/meetings/2024/engineering_meeting_24-10-14.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-14.md rename to meetings/2024/engineering_meeting_24-10-14.md diff --git a/meetings_notes/engineering_meeting_24-10-17.md b/meetings/2024/engineering_meeting_24-10-17.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-17.md rename to meetings/2024/engineering_meeting_24-10-17.md diff --git a/meetings_notes/engineering_meeting_24-10-21.md b/meetings/2024/engineering_meeting_24-10-21.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-21.md rename to meetings/2024/engineering_meeting_24-10-21.md diff --git a/meetings_notes/engineering_meeting_24-10-24.md b/meetings/2024/engineering_meeting_24-10-24.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-24.md rename to meetings/2024/engineering_meeting_24-10-24.md diff --git a/meetings_notes/engineering_meeting_24-10-28.md b/meetings/2024/engineering_meeting_24-10-28.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-28.md rename to meetings/2024/engineering_meeting_24-10-28.md diff --git a/meetings_notes/engineering_meeting_24-10-31.md b/meetings/2024/engineering_meeting_24-10-31.md similarity index 100% rename from meetings_notes/engineering_meeting_24-10-31.md rename to meetings/2024/engineering_meeting_24-10-31.md diff --git a/meetings_notes/engineering_meeting_24-11-04.md b/meetings/2024/engineering_meeting_24-11-04.md similarity index 100% rename from meetings_notes/engineering_meeting_24-11-04.md rename to meetings/2024/engineering_meeting_24-11-04.md diff --git a/meetings_notes/engineering_meeting_24-11-07.md b/meetings/2024/engineering_meeting_24-11-07.md similarity index 100% rename from meetings_notes/engineering_meeting_24-11-07.md rename to meetings/2024/engineering_meeting_24-11-07.md diff --git a/meetings_notes/engineering_meeting_24-11-18.md b/meetings/2024/engineering_meeting_24-11-18.md similarity index 100% rename from meetings_notes/engineering_meeting_24-11-18.md rename to meetings/2024/engineering_meeting_24-11-18.md diff --git a/meetings_notes/engineering_meeting_24-11-21.md b/meetings/2024/engineering_meeting_24-11-21.md similarity index 100% rename from meetings_notes/engineering_meeting_24-11-21.md rename to meetings/2024/engineering_meeting_24-11-21.md diff --git a/meetings_notes/engineering_meeting_24-11-28.md b/meetings/2024/engineering_meeting_24-11-28.md similarity index 100% rename from meetings_notes/engineering_meeting_24-11-28.md rename to meetings/2024/engineering_meeting_24-11-28.md diff --git a/meetings_notes/engineering_meeting_24-12-16.md b/meetings/2024/engineering_meeting_24-12-16.md similarity index 100% rename from meetings_notes/engineering_meeting_24-12-16.md rename to meetings/2024/engineering_meeting_24-12-16.md diff --git a/meetings_notes/engineering_meeting_24-12-30.md b/meetings/2024/engineering_meeting_24-12-30.md similarity index 100% rename from meetings_notes/engineering_meeting_24-12-30.md rename to meetings/2024/engineering_meeting_24-12-30.md