-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add instructions for running a tech radar refresh (#357)
* Create docs * Add files via upload * Create sample-leaflet.md * sample event-group.md * Delete docs * added the event docs * Update Sample-leaflet.md Refined and enhanced the instructions for the Tech Radar refresh process * Update event-group.md update group categories --------- Co-authored-by: Dami <[email protected]>
- Loading branch information
1 parent
5d63ed7
commit 2201df3
Showing
3 changed files
with
122 additions
and
0 deletions.
There are no files selected for viewing
Submodule data-and-analytics-engineering-tech-radar
added at
41d32b
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,79 @@ | ||
# Data and Analytics Engineering Tech Radar Refresh | ||
|
||
**Event Day:** | ||
**Event Time:** | ||
**Event Location:** | ||
|
||
## Overview | ||
|
||
The MoJ Data and Analytics Engineering community maintains a public Tech Radar to help align technology choices within and across our teams. This Tech Radar is based on the pioneering work by ThoughtWorks. | ||
|
||
The Tech Radar serves as a point-in-time snapshot of tools, techniques, platforms, languages, and frameworks relevant to our teams. Each technology or technique is represented by a `blip` and assigned a rating, which can change over time. Blips can appear or disappear, with a maximum of ~125 blips to make the Tech Radar navigable. We aim to refresh the Tech Radar on a yearly basis. | ||
|
||
We use GitHub discussions to provide feedback on the blips, which is then extracted using the GitHub GraphQL API and published to GitHub Pages using a GitHub workflow. We also use Zalando's radar.js JavaScript library to visualize the Tech Radar. | ||
|
||
## Order of Events | ||
|
||
- **14:00 - 14:05** - Welcome & Introductions (5 mins) | ||
- Brief welcome and overview of the Tech Radar process. | ||
- Introductions of team facilitators and participants. | ||
|
||
- **14:05 - 15:00** - Team Discussions (55 mins) | ||
- Teams discuss assigned categories. | ||
- Review existing entries, identify new technologies, and discuss their potential impact. | ||
- Use the shared repository for notes, new entries, and presentations. | ||
|
||
- **15:00 - 15:10** - Prep Team Slides (10 mins) | ||
- Team facilitators update slides. | ||
|
||
- **15:10 - 16:00** - Team Presentations (50 mins: 5 mins Presentation and 5 mins Q&A each) | ||
- Each team presents a summary of their discussions. | ||
- Highlight key takeaways, new entries, and any open questions or areas requiring further investigation. | ||
- Open forum for cross-team discussion and knowledge sharing. | ||
|
||
- **16:00 - 16:05** - Final Thoughts & Action Planning (5 mins) | ||
- Recap of key takeaways and emerging trends. | ||
- Identification of action items and next steps for implementation. | ||
- Closing remarks and appreciation for participation. | ||
|
||
## Team Discussion | ||
|
||
We have divided the Data and Analytics Engineering community into five groups. Each group has an assigned facilitator and a category of blips to review. This approach helps focus feedback during the event, and, progressively, members of other group will have the opportunity to provide feedback on other blips. | ||
|
||
1. Open the Tech Radar discussions link. | ||
2. Filter on assigned category or the relevant analytics engineering label. | ||
3. The group facilitator will select the initial blip for discussion. | ||
4. The group facilitator will create a new comment with the heading `## 2024 August` if it is not already there. | ||
5. The group facilitator will add a link to the technology if not already present. | ||
6. Add an emoji to represent the assignment – have a look at the labels for a short explanation of the assignment or the Tech Radar for a longer explanation. | ||
7. Add any relevant comments or insights. | ||
8. The group facilitator will assign an assessment/close the discussion based on the emojis. | ||
9. Discuss any disagreements before proceeding to the next blip. | ||
10. There will be 10 mins at the end of the 1-hour session to introduce new blips. | ||
11. You can provide feedback on other blips during the presentation or afterwards on GitHub Discussions. | ||
|
||
## What Are We Gaining from This Event? | ||
|
||
We aim to gather diverse perspectives and expertise on current and emerging technologies from our engineers, and reflect the collective input in our GitHub Discussions for an accurate Tech Radar refresh. | ||
|
||
## What Will We Do After the Event? | ||
|
||
We will seek input from engineers who were not available on the event day. Based on all the input received during and after the event, we aim to update our Tech Radar on a later date. | ||
|
||
## How Can I Learn More About Tech Radar? | ||
|
||
You can learn more about Tech Radar by visiting the Tech Radar GitHub repo, where you can find instructions on how to use Tech Radar locally. If you want to manage discussions, here is the discussion link. | ||
|
||
## What Is My Role as a Group Facilitator on the Event Day? | ||
As a group facilitator, your responsibilities on the event day include: | ||
- Familiarize yourself with the discussion process. | ||
- Ensure everyone in your group focuses on the same blip at a time. | ||
- Encourage participation and manage time effectively. | ||
- Make sure each team member adds their emoji assessment for each blip. | ||
- Verify that every blip has a technology link and necessary information. | ||
- Introduce recommended technologies, ensuring the total number of blips for your category does not exceed 25. | ||
- Provide a concise summary of your team's discussions and outcomes at the end of the session. | ||
- Present any open questions or challenges that emerged during the discussion. | ||
- Update the markdown-based slides, summarizing the most controversial new and paused blips. Follow these instructions to update the slides. | ||
- Seek feedback from engineers who were not available on the event day. | ||
- Ensure all blips in your category are assigned or closed prior to the agreed final refresh date. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Tech Radar Event: Group Distribution and Assignments | ||
|
||
## Platforms | ||
|
||
**Coordinator:** | ||
|
||
|
||
**Team Members:** | ||
|
||
|
||
## Tools | ||
|
||
**Coordinator:** | ||
|
||
|
||
**Team Members:** | ||
|
||
|
||
## Languages & Frameworks | ||
|
||
**Coordinator:** | ||
|
||
|
||
**Team Members:** | ||
|
||
|
||
## Techniques | ||
|
||
**Coordinator:** | ||
|
||
|
||
**Team Members:** | ||
|
||
## Analytics Engineer | ||
|
||
**Coordinator:** | ||
|
||
|
||
**Team Members:** | ||
|
||
|
||
|