Skip to content

Commit edb3b73

Browse files
EngerimEngerim
committed
PLT-1074 - Switch to other technology
* rewrite to tech radar framework
1 parent a4b9f57 commit edb3b73

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+594
-6892
lines changed

‎.github/workflows/pages.yml

+55
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
name: Flaconi Technology Radar
2+
3+
on:
4+
pull_request:
5+
push:
6+
branches:
7+
#- master
8+
9+
permissions:
10+
contents: read
11+
pages: write
12+
id-token: write
13+
14+
jobs:
15+
build:
16+
runs-on: ubuntu-latest
17+
18+
steps:
19+
- name: Checkout 🛎️
20+
uses: actions/checkout@v4
21+
22+
- name: Setup Node.js ⚙️ - Cache dependencies ⚡ - Install dependencies 🔧
23+
uses: actions/setup-node@v4
24+
with:
25+
cache: yarn
26+
node-version: "20"
27+
- name: Install dependencies 📦
28+
run: yarn install
29+
- name: Setup Pages ⚙️
30+
id: pages
31+
uses: actions/configure-pages@v4
32+
#if: ${{ github.ref == 'refs/heads/master' }}
33+
with:
34+
static_site_generator: next
35+
36+
- name: Build with Next.js 🏗️
37+
run: npm run build
38+
39+
- name: Upload artifact 📡
40+
uses: actions/upload-pages-artifact@v3
41+
with:
42+
path: ./build
43+
44+
deploy:
45+
environment:
46+
name: github-pages
47+
url: ${{ steps.deployment.outputs.page_url }}
48+
49+
runs-on: ubuntu-latest
50+
needs: build
51+
52+
steps:
53+
- name: Publish to GitHub Pages 🚀
54+
id: deployment
55+
uses: actions/deploy-pages@v4

‎.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,5 @@ node_modules/
44

55
# yarn
66
yarn-error.log
7+
.techradar
8+
build/

‎about.md

+77
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# How to use the Technology Radar
2+
3+
### Introduction
4+
5+
Technology is advancing rapidly, with new technologies and innovations constantly emerging.
6+
7+
It is essential for a company like Flaconi to continually improve and keep track of the latest valuable innovations.
8+
It is important to actively seek out innovations and new technologies and periodically question established technologies and methods.
9+
10+
But, it is also important to wisely choose which technologies to use in our daily work and in the different projects we are carrying out. As we all know: There is no silver bullet.
11+
12+
### What is the Flaconi Technology Radar?
13+
14+
The Tech Radar provides an overview of different technologies, including languages, frameworks,
15+
tools, and patterns, as well as platforms, that we consider 'new or noteworthy.' The radar does not
16+
cover all established technologies; instead, it focuses on items that have recently gained
17+
significance or undergone changes. Items previously featured in the radar are not listed on the
18+
homepage but remain available in the complete overview and search.
19+
20+
### How it is created
21+
22+
The items in the technology radar are suggested by different teams, many of which are related to the
23+
work and challenges faced by the teams in various projects. In fact, we do not include anything on
24+
the radar that we haven't personally tested at least once.
25+
26+
Numerous valuable discussions have taken place in various expert groups regarding the classification
27+
and details of each technology and innovation. The culmination of these discussions is reflected in
28+
the latest technology radar.
29+
30+
### How should it be used
31+
32+
The radar serves as an overview of technologies that we believe everyone in the teams should be
33+
aware of at present.
34+
35+
Its goal is to guide and inspire daily work within the teams. Additionally, it aims to provide
36+
valuable information and a high-level perspective to enable decisions to be made with a deeper
37+
understanding of the subject matter, resulting in more informed and coordinated choices.
38+
39+
We also hope that developers outside of Flaconi will find the information in our technology overview
40+
inspiring.
41+
42+
We categorize the items into four quadrants, and sometimes, when it's not entirely clear where an
43+
item belongs, we choose the best fit.
44+
45+
#### The quadrants are:
46+
47+
- **Languages & Frameworks:** In this category, we include development languages like Node.js or
48+
Golang, as well as low-level development frameworks such as Express.js or Flask. These are valuable
49+
for implementing various types of custom software.
50+
- **Tools:** This section is dedicated to a wide range of software tools, from small utilities to
51+
more extensive software projects.
52+
- **Methods & Patterns:** Patterns hold enduring significance, with many of them standing the test
53+
of time compared to some tools or frameworks. This category is where we provide information on
54+
methods and patterns related to development, continuous integration, testing, organization,
55+
architecture, and more.
56+
- **Platforms & Operations:** In this quadrant, we group technologies related to the operation of
57+
software, infrastructure, and platform-related tools and services.
58+
59+
#### Each of the items is classified in one of these rings:
60+
61+
- **Adopt:** We wholeheartedly recommend this technology. It has been extensively used in many teams
62+
for an extended period, proving its stability and utility.
63+
- **Trial:** We have successfully implemented this technology and suggest taking a closer look at it
64+
in this category. The aim here is to scrutinize these items more closely with the intention of
65+
elevating them to the 'Adopt' level.
66+
- **Assess:** We have experimented with this technology and find it promising. We recommend
67+
exploring these items when you encounter a specific need for the technology in your project.
68+
- **Hold:** This category is somewhat unique. Unlike the others, it advises discontinuing or
69+
refraining from using certain technologies. This does not necessarily imply that they are
70+
inherently bad; it often may be acceptable to use them in existing projects. However, we move
71+
items here when we believe they should no longer be employed, as we have identified better options
72+
or alternatives.
73+
74+
### Contributing to the Flaconi Technology Radar
75+
76+
Contributions and source code of the Flaconi Tech Radar are on [GitHub](https://github.com/flaconi/tech-radar). Inspired by
77+
[AOE Tech Radar](https://github.com/AOEpeople/aoe_technology_radar).

‎config.json

+144
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
{
2+
"basePath": "/tech-radar",
3+
"baseUrl": "",
4+
"editUrl": "https://github.dev/flaconi/tech-radar/blob/master/radar/{release}/{id}.md",
5+
"logoFile": "logo.svg",
6+
"jsFile": "",
7+
"toggles": {
8+
"showChart": true,
9+
"showTagFilter": true,
10+
"showQuadrantList": true,
11+
"showEmptyRings": false
12+
},
13+
"sections": ["radar", "tags", "list"],
14+
"colors": {
15+
"foreground": "#E5E8E9",
16+
"background": "#38464D",
17+
"highlight": "#F58300",
18+
"content": "#E5E8E9",
19+
"text": "#575757",
20+
"link": "#F58300",
21+
"border": "rgba(255, 255, 255, 0.1)",
22+
"tag": "rgba(255, 255, 255, 0.1)"
23+
},
24+
"quadrants": [
25+
{
26+
"id": "languages-and-frameworks",
27+
"title": "Languages & Frameworks",
28+
"description": "A selection of programming languages, alongside essential frameworks for building a variety of custom software.",
29+
"color": "#7092F5"
30+
},
31+
{
32+
"id": "methods-and-patterns",
33+
"title": "Methods & Patterns",
34+
"description": "Key software development methods and design patterns, covering everything from continuous integration and testing to architecture.",
35+
"color": "#535EAA"
36+
},
37+
{
38+
"id": "platforms-and-operations",
39+
"title": "Platforms & Operations",
40+
"description": "Technologies and tools for software and infrastructure operations, including platforms and services for managing and scaling applications.",
41+
"color": "#436D84"
42+
},
43+
{
44+
"id": "tools",
45+
"title": "Tools",
46+
"description": "A range of software tools, from simple productivity enhancers to comprehensive project solutions, catering to various project needs.",
47+
"color": "#278489"
48+
}
49+
],
50+
"rings": [
51+
{
52+
"id": "adopt",
53+
"title": "Adopt",
54+
"description": "Technologies we have high confidence in to serve our purpose, also in large scale. Technologies with a usage culture in our Flaconi production environment, low risk and recommended to be widely used.",
55+
"color": "#4A9940",
56+
"radius": 0.5,
57+
"strokeWidth": 5
58+
},
59+
{
60+
"id": "trial",
61+
"title": "Trial",
62+
"description": "Technologies that we have seen work with success in project work to solve a real problem; first serious usage experience that confirm benefits and can uncover limitations. TRIAL technologies are slightly more risky; some engineers in our organisation walked this path and will share knowledge and experiences.",
63+
"color": "#E4AE1D",
64+
"radius": 0.69,
65+
"strokeWidth": 3
66+
},
67+
{
68+
"id": "assess",
69+
"title": "Assess",
70+
"description": "Technologies that are promising and have clear potential value-add for us; technologies worth to invest some research and prototyping efforts in to see if it has impact. ASSESS technologies have higher risks; they are often brand new and highly unproven in our organisation. You will find some engineers that have knowledge in the technology and promote it, you may even find teams that have started a prototyping effort.",
71+
"color": "#535EAA",
72+
"radius": 0.85,
73+
"strokeWidth": 2
74+
},
75+
{
76+
"id": "hold",
77+
"title": "Hold",
78+
"description": "Technologies not recommended to be used for new projects. Technologies that we think are not (yet) worth to (further) invest in. HOLD technologies should not be used for new projects, but usually can be continued for existing projects.",
79+
"color": "#E35726",
80+
"radius": 1,
81+
"strokeWidth": 0.75
82+
}
83+
],
84+
"flags": {
85+
"new": {
86+
"color": "#D74A39",
87+
"title": "New",
88+
"titleShort": "N",
89+
"description": "New in this version"
90+
},
91+
"changed": {
92+
"color": "#535EAA",
93+
"title": "Changed",
94+
"titleShort": "C",
95+
"description": "Recently changed"
96+
},
97+
"default": {
98+
"description": "Unchanged"
99+
}
100+
},
101+
"chart": {
102+
"size": 800,
103+
"blipSize": 12
104+
},
105+
"social": [
106+
{
107+
"href": "https://www.instagram.com/flaconi/",
108+
"icon": "instagram"
109+
},
110+
{
111+
"href": "https://www.facebook.com/flaconi.de/",
112+
"icon": "facebook"
113+
},
114+
{
115+
"href": "https://www.linkedin.com/company/flaconi-gmbh",
116+
"icon": "linkedIn"
117+
},
118+
{
119+
"href": "https://www.youtube.com/c/flaconi",
120+
"icon": "youtube"
121+
},
122+
{
123+
"href": "https://github.com/flaconi",
124+
"icon": "github"
125+
}
126+
],
127+
"imprint": "https://www.flaconi.de/impressum/",
128+
"labels": {
129+
"title": "Technology Radar",
130+
"imprint": "Imprint",
131+
"quadrant": "Quadrant",
132+
"quadrantOverview": "Quadrant Overview",
133+
"zoomIn": "Zoom in",
134+
"filterByTag": "Filter by Tag",
135+
"footer": "",
136+
"notUpdated": "This item was not updated in last three versions of the Radar. Should it have appeared in one of the more recent editions, there is a good chance it remains pertinent. However, if the item dates back further, its relevance may have diminished and our current evaluation could vary. Regrettably, our capacity to consistently revisit items from past Radar editions is limited.",
137+
"notFound": "404 - Page not found",
138+
"pageAbout": "How to use Flaconi Technology Radar?",
139+
"pageOverview": "Technologies Overview",
140+
"pageSearch": "Search",
141+
"searchPlaceholder": "What are you looking for?",
142+
"metaDescription": ""
143+
}
144+
}

‎custom.css

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
/* Use this file to optionally override global css styles and use with caution. */
2+
/* See README.md for hints and examples: https://github.com/AOEpeople/aoe_technology_radar/ */

0 commit comments

Comments
 (0)