Merge pull request #3 from martyngigg/technology-radar-v1

Add remaining radar blip descriptions

data/radar/preview/soap-services.md

@@ -1,7 +1,17 @@
 ---
-title: SOAP Services
+title: "SOAP Services"
 quadrant: techniques
 ring: hold
 ---
 
-[SOAP Services](https://www.javatpoint.com/soap-web-services)
+[SOAP Services](https://en.wikipedia.org/wiki/SOAP) is a communication protocol
+for the implementation of web services. It uses an XML formatted document, called
+a WSDL, to describe the service and the available operations.
+
+SOAP services have become less popular with the rise of REST API designs.
+REST offers more flexibility as it permits data transfer in a variety of
+formats while also using stateless operations. SOAP definitions also have to
+describe the whole service thereby making changes to elements of a service,
+e.g. a single operation, more difficult to change without impacting all clients.
+For these reasons SOAP has been placed in hold and it is recommended that it is
+not used for new projects.

data/radar/preview/sql-developer.md

@@ -1,7 +1,11 @@
 ---
-title: SQL developer
+title: "SQL Developer"
 quadrant: platforms
 ring: hold
 ---
 
-[SQL developer](https://www.oracle.com/database/sqldeveloper/)
+[SQL Developer](https://www.oracle.com/database/sqldeveloper/) is an integrated
+development environment for developing and managing Oracle databases both
+on-premise and in the cloud.
+
+We have placed this in hold due to a move away from Oracle DB solutions.

data/radar/preview/stfc-cloud.md

@@ -1,7 +1,17 @@
 ---
-title: STFC Cloud
+title: "STFC Cloud"
 quadrant: platforms
 ring: adopt
 ---
 
-[STFC Cloud](https://openstack.stfc.ac.uk/auth/login/?next=/)
+The [STFC Cloud](https://stfc.atlassian.net/wiki/spaces/CLOUDKB/overview) is an
+internal, private cloud-computing service developed and maintained by the
+Scientific Computing Department. Based on Openstack, it offers similar services
+to public cloud offerings such as compute, block storage, object storage,
+load balancers etc. ISIS funds hardware in the cloud both directly and through
+the IRIS project.
+
+A mature platform running production workloads across STFC including many projects
+across the division. It is recommended that new and existing projects investigate
+the suitability of the STFC cloud before looking to ISIS-based hardware
+solutions.

data/radar/preview/sycl.md

@@ -4,4 +4,11 @@ quadrant: languages-and-frameworks
 ring: assess
 ---
 
-[SYCL](https://www.khronos.org/sycl/)
+[SYCL](https://www.khronos.org/sycl/) defines C++, C++17 is a minimum, abstractions
+to enable heterogeneous device programming. A major goal of SYCL is to enable different
+heterogeneous devices to be used in a single application, for example
+simultaneous use of CPUs, GPUs, and FPGAs; without the need to write low-level
+kernel code for a particular device.
+
+This is not in active use by any one within the division but is interesting
+enough that it has been placed in assess.

data/radar/preview/tailwind-css.md

@@ -1,7 +1,13 @@
 ---
-title: Tailwind CSS
+title: "Tailwind CSS"
 quadrant: languages-and-frameworks
-ring: assess
+ring: trial
 ---
 
-[Tailwind CSS](https://tailwindcss.com/)
+[Tailwind](https://tailwindcss.com/) is a framework that supplies CSS classes
+to be composed together directly within markup rather than separating style
+definitions into either out of line definitions or separate style files.
+CSS files are still shipped to the browser but these are now products of the
+tailwind compiler and not maintained by hand.
+
+This radar is is developed with Tailwind so we have placed it in the trail ring.

data/radar/preview/test-driven-development.md

@@ -1,7 +1,18 @@
 ---
-title: Test-Driven Development
+title: "Test-Driven Development"
 quadrant: techniques
 ring: adopt
 ---
 
-[Test-Driven Development](https://www.agilealliance.org/glossary/tdd/)
+[Test-Driven Development](https://www.agilealliance.org/glossary/tdd/) is a method
+of software development that encourages a style of coding where:
+
+- a unit test is first created for a feature that does not exist
+- the unit test is executed and it fails
+- minimal code is written that causes the test to pass
+- refactor code for [simplicity](https://www.agilealliance.org/glossary/rules-of-simplicity/).
+
+This loop is repeated and a suite a tests builds over time.
+
+This is a well-known software development tool that is practiced across the division
+so sits in adopt.

data/radar/preview/typescript.md

@@ -1,7 +1,13 @@
 ---
-title: Typescript
+title: TypeScript
 quadrant: languages-and-frameworks
 ring: adopt
 ---
 
-[Typescript](https://www.typescriptlang.org)
+[TypeScript](https://www.typescriptlang.org) adds additional syntax to
+JavaScript allowing for strong typing. TypeScript compiles to JavaScript so that
+no additional tools are required to run the code on the client side. Typing also
+allows for better integration with code completion in editors.
+
+Widely adopt by all projects using JavaScript as a language so it resides in the
+adopt ring.

data/radar/preview/uml.md

@@ -5,3 +5,11 @@ ring: adopt
 ---
 
 [UML](https://www.visual-paradigm.com/guide/uml-unified-modeling-language/what-is-uml/)
+is a modeling language consisting of a set of diagrams for representing
+artifacts of a system that enable teams to communicate with a common language
+regarding elements such as code, process or state, to name a few.
+Many diagram types exist depending what is but being modeled but common diagrams
+in software include class, sequence and package.
+
+A common tool used in many aspects of the development process we consider this
+adopted.

data/radar/preview/virtualbox.md

@@ -0,0 +1,17 @@
+---
+title: VirtualBox
+quadrant: platforms
+ring: adopt
+---
+
+[VirtualBox](https://www.virtualbox.org/) is a desktop virtualisation
+technology for running guest operating systems from within a host. [Guest
+additions](https://www.virtualbox.org/manual/ch04.html) are required to be
+installed inside the guest VM to enable certain pieces of functionality.
+
+The core product and guest additions are free to use and licensed under the
+GPLv3. An extension pack, distinct from the guest additions, is licensed
+separately and should not be used without an appropriate Oracle license. While
+desktop virtualisation is still useful, particularly for desktop environments,
+it is recommended that container-based solutions are explored first.
+We continue to place this adopt until it is clearer that it is no longer useful.

data/radar/preview/vmware.md

@@ -4,4 +4,13 @@ quadrant: platforms
 ring: adopt
 ---
 
-[VMWare](https://www.vmware.com/uk.html)
+[VMWare](https://www.vmware.com/uk.html) is a virtualisation platform for both
+desktop and server hardware.
+[VMWare Workstation Player](https://www.vmware.com/uk/products/workstation-player.html)
+is a free version of the desktop software that does not offer any kind of support.
+
+It is adopted for virtualisation on server hardware but less so for desktop
+virtualisation where Virtualbox is preferred. While desktop virtualisation is
+still useful, particularly for desktop environments, it is recommended that
+container-based solutions are explored first.
+We continue to place this adopt until it is clearer that it is no longer useful.

data/radar/preview/windows-subsystem-for-linux.md

@@ -0,0 +1,12 @@
+---
+title: "Windows Subsystem for Linux"
+quadrant: tools
+ring: adopt
+---
+
+The [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/),
+or WSL for short, allows users to run GNU/Linux environments directly from within
+Windows without the need for a virtual machine. This gives access to commonly
+used open-source tooling frequently required by developers.
+
+Used reguarly by most teams within the division it is placed in adopt.