more glossary and language

Author: Phil Hawksworth

src/site/_data/glossary.yaml

@@ -33,14 +33,15 @@
 
 - term: 'Decoupling'
   id: 'decoupling'
+  definition: 'Decoupling is the process of creating a clean separation between systems or services. By decoupling the services needed to operate a site, each component part can become easier to reason about, can by independantly swapped out or upgraded, and can be designated the purvue of dedicated specialsts either within an organisation, or as a third party.'
 
 - term: 'Dynamic server'
   id: 'dynamic-server'
-  
+
 - term: 'API'
   id: 'api'
   definition: 'API is the acronym for Application Programming Interface. It defines interactions that allows two applications to talk to each other.'
-  
+
 - term: 'API Economy'
   id: 'api-economy'
   definition: 'A term that has come to mean the depth and breadth of APIs that are available for developers to use in the current landscape.'
@@ -53,12 +54,12 @@
   id: 'monolith'
 
 - term: 'Monorepo'
-  id: 'monorepo'  
+  id: 'monorepo'
 
 - term: 'Markup'
   id: 'Markup'
 
 - term: 'Markdown'
   id: 'Markdown'
 
-  
+

src/site/why-jamstack.njk

@@ -15,14 +15,16 @@ layout: layouts/base.njk
   <h2>Security</h2>
   <p>
     The Jamstack removes multiple moving parts and systems from the hosting infrastructure resulting in fewer servers and systems to harden against attack.
-    Serving pages and assets as pre-generated files allows read-only hosting reducing attack vectors even further. Meanwhile dynamic tools and services can be provided by vendors with teams dedicated to securing their specific systems and providing high levels of service.
+  </p>
+  <p>
+    Serving pages and assets as <a href="/glossary/pre-render/">pre-generated</a> files allows read-only hosting reducing attack vectors even further. Meanwhile dynamic tools and services can be provided by vendors with teams dedicated to securing their specific systems and providing high levels of service.
   </p>
 </section>
 
 <section>
   <h2>Scale</h2>
   <p>
-    Popular architectures deal with heavy traffic loads by adding logic to cache popular views and resources. The Jamstack provides this by default. When sites can be served entirely from a CDN there is no complex logic or workflow to determine what assets can be cached and when.
+    Popular architectures deal with heavy traffic loads by adding logic to cache popular views and resources. The Jamstack provides this by default. When sites can be served entirely from a <a href="/glossary/cdn/">CDN</a> there is no complex logic or workflow to determine what assets can be cached and when.
   </p>
   <p>
     With Jamstack sites everything can be cached in a content delivery network. With simpler deployments, built-in redundancy and incredible load capacity.
@@ -35,14 +37,14 @@ layout: layouts/base.njk
     Page loading speeds have an impact on user experience and conversion. Jamstack sites remove the need to generate page views on a server at request time by instead generating pages ahead of time during a build.
   </p>
   <p>
-    With all the pages are already available on a CDN close to the user and ready to serve, very high performance is possible without introducing expensive or complex infrastructure.
+    With all the pages are already available on a <a href="/glossary/cdn/">CDN</a> close to the user and ready to serve, very high performance is possible without introducing expensive or complex infrastructure.
   </p>
 </section>
 
 <section>
   <h2>Maintainability</h2>
   <p>
-    When hosting complexity is reduced, so are maintenance tasks. A pre-generated site, being served directly from a simple host or directly from a CDN does not need a team of experts to "keep the lights on".
+    When hosting complexity is reduced, so are maintenance tasks. A <a href="/glossary/pre-render/">pre-generated</a> site, being served directly from a simple host or directly from a CDN does not need a team of experts to "keep the lights on".
   </p>
   <p>
     The work was done during the build, so now the generated site is stable and can be hosted without servers which might require patching, updating and maintain.
@@ -52,7 +54,7 @@ layout: layouts/base.njk
 <section>
   <h2>Portability</h2>
   <p>
-    Jamstack sites are pre-generated. That means that you can host them from a wide variety of hosting services and have greater ability to move them to your preferred host. Any simple static hosting solution should be able to serve a Jamstack site.
+    Jamstack sites are <a href="/glossary/pre-render/">pre-generated</a>. That means that you can host them from a wide variety of hosting services and have greater ability to move them to your preferred host. Any simple static hosting solution should be able to serve a Jamstack site.
   </p>
   <p>
     Bye-bye infrastructure lock-in.
@@ -62,7 +64,7 @@ layout: layouts/base.njk
 <section class="mb-20 pb-20 border-gray-400 border-b ">
   <h2>Developer Experience</h2>
   <p>
-    Jamstack sites can be built with a wide variety of tools. They do not depend on the proprietary technologies or exotic and little known frameworks. Instead, they build on widely available tools and conventions. As a result, it's not hard to find enthusiastic and talented developers who have the right skills to build with the Jamstack. Efficiency and effectiveness can
+    Jamstack sites can be built with a wide variety of tools. They do not depend on the proprietary technologies or exotic and little known frameworks. Instead, they build on widely available tools and conventions. As a result, it's not hard to find enthusiastic and talented developers who have the right skills to build with the Jamstack. Efficiency and effectiveness can propser.
   </p>
 </section>