AJR/TechradarDev
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: proofread quadrant descriptions and how to

Browse Source
This commit is contained in:
Stefan Rotsch
2023-11-01 09:12:18 +01:00
committed by Stefan Rotsch
parent 3f1bd03582
commit 6bcd574eaf
1 changed files with 45 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

69
public/messages.json
View File

@@ -1,81 +1,102 @@
{
"footerFootnote": "AOE is a leading global provider of services for digital transformation and digital business models. AOE relies exclusively on established Enterprise Open Source technologies. This leads to innovative solutions, digital products and portals in agile software projects, and helps build long-lasting, strategic partnerships with our customers.",
"socialLinks": [
{ "href": "https://www.facebook.com/aoepeople", "iconName": "facebook" },
{ "href": "https://twitter.com/aoepeople", "iconName": "twitter" },
{ "href": "https://www.linkedin.com/company/aoe", "iconName": "linkedIn" },
{ "href": "https://www.xing.com/company/aoe", "iconName": "xing" },
{ "href": "https://www.instagram.com/aoepeople", "iconName": "instagram" },
{ "href": "https://www.youtube.com/user/aoepeople", "iconName": "youtube" },
{ "href": "https://github.com/aoepeople", "iconName": "github" }
{
"href": "https://www.facebook.com/aoepeople",
"iconName": "facebook"
},
{
"href": "https://twitter.com/aoepeople",
"iconName": "twitter"
},
{
"href": "https://www.linkedin.com/company/aoe",
"iconName": "linkedIn"
},
{
"href": "https://www.xing.com/company/aoe",
"iconName": "xing"
},
{
"href": "https://www.instagram.com/aoepeople",
"iconName": "instagram"
},
{
"href": "https://www.youtube.com/user/aoepeople",
"iconName": "youtube"
},
{
"href": "https://github.com/aoepeople",
"iconName": "github"
}
],
"pageHelp": {
"paragraphs": [
{
"headline": "Introduction",
"values": [
"Technology is moving fast and new technologies and innovations appear continuously.",
"It's essential for a development and technology company such as AOE to constantly improve and keep track with the latest useful innovations. It is important to openly look for innovations and new technologies and to question established technologies and methods every now and then.",
"Technology is advancing rapidly, with new technologies and innovations constantly emerging.",
"It is essential for a development and technology company like AOE to continually improve and keep track of the latest valuable innovations. It is important to actively seek out innovations and new technologies and periodically question established technologies and methods.",
"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."
]
},
{
"headline": "What is the AOE Technology Radar",
"values": [
"The Tech Radar is an overview of different technologies - from languages, frameworks, tools and patterns to platforms - that we consider \"new or mentionable\". The radar therefore doesn't provide an overview of all established technologies - but it focuses on items that have recently gained in importance or changed. Items that have been on the radar in previous versions are not listed on the homepage, but they are still available in the complete overview and in the search."
"The Tech Radar provides an overview of different technologies, including languages, frameworks, tools, and patterns, as well as platforms, that we consider 'new or noteworthy.' The radar does not cover all established technologies; instead, it focuses on items that have recently gained significance or undergone changes. Items previously featured in the radar are not listed on the homepage but remain available in the complete overview and search."
]
},
{
"headline": "How it is created",
"values": [
"The items in the technology radar are raised by the different teams and therefore a lot of the items are related to the work and challenges the teams face in the different projects. In fact, we don't include anything on the radar that we haven't tried ourselves at least once.",
"There have been a lot of valuable discussions in different expert groups about the classification and details of each of technologies and innovations. And the result of all this can be found in the latest technology radar."
"The items in the technology radar are suggested by different teams, many of which are related to the work and challenges faced by the teams in various projects. In fact, we do not include anything on the radar that we haven't personally tested at least once.",
"Numerous valuable discussions have taken place in various expert groups regarding the classification and details of each technology and innovation. The culmination of these discussions is reflected in the latest technology radar."
]
},
{
"headline": "How should it be used",
"values": [
"The radar acts as an overview of technologies that we think everyone in the teams should currently know about.",
"Its goal is to act as a guide and inspiration for the daily work in the teams. Its purpose is also to provide helpful information and a bird's-eye perspective - so that decisions can be taken with a much deeper understanding of the subject matter. This results in more informed and coordinated decisions.",
"We also hope that developers outside of AOE find the information in our technology overview inspirational.",
"We group or categorize the items in 4 quadrants - (sometimes, when it's not 100% clear where a item belongs, we choose the best fit)."
"The radar serves as an overview of technologies that we believe everyone in the teams should be aware of at present.",
"Its goal is to guide and inspire daily work within the teams. Additionally, it aims to provide valuable information and a high-level perspective to enable decisions to be made with a deeper understanding of the subject matter, resulting in more informed and coordinated choices.",
"We also hope that developers outside of AOE will find the information in our technology overview inspiring.",
"We categorize the items into four quadrants, and sometimes, when it's not entirely clear where an item belongs, we choose the best fit."
]
}
],
"quadrants": [
{
"name": "Languages & Frameworks",
"description": "We've placed development languages (such as Scala or Golang) here, as well as more low-level development frameworks (such as Play or Symfony), which are useful for implementing custom software of all kinds."
"description": "In this category, we include development languages like Scala or Golang, as well as low-level development frameworks such as Play or Symfony. These are valuable for implementing various types of custom software."
},
{
"name": "Tools",
"description": "Here we put different software tools - from small helpers to bigger software projects."
"description": "This section is dedicated to a wide range of software tools, from small utilities to more extensive software projects."
},
{
"name": "Methods & Patterns",
"description": "Patterns are so important, and a lot of them are valid for a long time (compared to some tools or frameworks). So, this is the category where we put information on methods and patterns concerning development, continuous x, testing, organization, architecture, etc."
"description": "Patterns hold enduring significance, with many of them standing the test of time compared to some tools or frameworks. This category is where we provide information on methods and patterns related to development, continuous integration, testing, organization, architecture, and more."
},
{
"name": "Platforms & Operations",
"description": "This quadrant clusters technologies around the operation of software and infrastructure related platforms, tools and services."
"description": "In this quadrant, we group technologies related to the operation of software, infrastructure, and platform-related tools and services."
}
],
"rings": [
{
"name": "Adopt",
"description": "We can clearly recommend this technology. We have used it for longer period of time in many teams and it has proven to be stable and useful."
"description": "We wholeheartedly recommend this technology. It has been extensively used in many teams for an extended period, proving its stability and utility."
},
{
"name": "Trial",
"description": "We have used it with success and recommend to have a closer look at the technology in this ring. The goal of items here is to look at them more closely, with the goal to bring them to the adopt level."
"description": "We have successfully implemented this technology and suggest taking a closer look at it in this category. The aim here is to scrutinize these items more closely with the intention of elevating them to the 'Adopt' level."
},
{
"name": "Assess",
"description": "We have tried it out and we find it promising. We recommend having a look at these items when you face a specific need for the technology in your project."
"description": "We have experimented with this technology and find it promising. We recommend exploring these items when you encounter a specific need for the technology in your project."
},
{
"name": "Hold",
"description": "This category is a bit special. Unlike the others, we recommend to stop doing or using something. That does not mean that they are bad and it often might be ok to use them in existing projects. But we move things here if we think we shouldn't do them anymore - because we see better options or alternatives now."
"description": "This category is somewhat unique. Unlike the others, it advises discontinuing or refraining from using certain technologies. This does not necessarily imply that they are inherently bad; it often may be acceptable to use them in existing projects. However, we move items here when we believe they should no longer be employed, as we have identified better options or alternatives."
}
],
"sourcecodeLink": {