Merge pull request #371 from jamstack/pnh/what-is-jamstack-expansion

Pnh/what is jamstack expansion

Author: Hugues Tennier

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/_includes/footer.njk

@@ -3,7 +3,7 @@
     <ul class="text-left md:flex justify-between">
       <li class="p-2">&copy; {{ page.date | formatDate('yyyy') }}  Netlify </li>
       <li class="p-2"><a href="https://jamstack.org/slack">Chat on Slack</a></li>
-      <li class="p-2"><a href="">Netlify Support</a></li>
+      <li class="p-2"><a href="https://community.netlify.com/">Netlify Support</a></li>
       <li class="p-2"><a href="{{ pkg.repository.url }}">Code on GitHub</a></li>
     </ul>
   </footer>

src/site/examples.njk

@@ -45,7 +45,7 @@ layout: layouts/base.njk
 <section class="my-12">
   <h2 class="text-white font-semi-bold text-3xl">Contribute</h2>
   <p>
-    Should your site be featured here in this gallery? Let us know about it by <a href="{{ pkg.repository.url }}" target="_BLANK" rel="noopener">opening a pull request</a>.
+    Should your site be featured here in this gallery? Let us know about it by <a href="{{ pkg.repository.url }}/pulls" target="_BLANK" rel="noopener">opening a pull request</a>.
   </p>
 </section>
 

src/site/glossary-pages.njk

@@ -25,7 +25,7 @@ eleventyComputed:
     {{- item.definition | safe }}
   {% endmarkdown %}
   </div>
-  <p class="mt-12 mb-20">You can help us to expand and improve this glossary <a href="#">by creating an issue</a>.</p>
+  <p class="mt-12 mb-20">You can help us to expand and improve this glossary <a href="{{ pkg.repository.url }}/issues">by creating an issue</a>.</p>
 </section>
 
 {% include "components/join-the-movement.njk" %}

src/site/glossary.njk

@@ -20,7 +20,7 @@ layout: layouts/base.njk
 
 <section class="border-gray-400 border-b mb-10">
   {{ content | safe }}
-  <p class="mt-12 mb-20">You can help us to expand and improve this glossary <a href="#">by creating an issue</a>.</p>
+  <p class="mt-12 mb-20">You can help us to expand and improve this glossary <a href="{{ pkg.repository.url }}/issues">by creating an issue</a>.</p>
 </section>
 
 {% include "components/join-the-movement.njk" %}

src/site/what-is-jamstack.njk

@@ -19,22 +19,31 @@ layout: layouts/base.njk
 <section>
   <h2>Pre-rendering</h2>
   <p>
-    With Jamstack, the entire front end is prebuilt into highly optimized static pages and assets during a build process. This process of pre-rending results in sites which can be served directly from a <a href="/glossary/cdn">CDN</a>, reducing the cost, complexity and risk, of dynamic servers as cirticial infrastructure.
+    With Jamstack, the entire front end is prebuilt into highly optimized static pages and assets during a build process. This process of pre-rending results in sites which can be served directly from a <a href="/glossary/cdn/">CDN</a>, reducing the cost, complexity and risk, of dynamic servers as cirticial infrastructure.
   </p>
   <p>
-    With so many popular tools for generating sites</a>, like Gatsby, Hugo, Jekyll, Eleventy, NextJS, <a href="/generators">and very many more</a>, most web developers are already familiar with the tools needed to become productive Jamstack developers.
+    With so many popular tools for generating sites</a>, like <a href="/generators/gatsby/">Gatsby</a>, <a href="/generators/hugo/">Hugo</a>, <a href="/generators/jekyll/">Jekyll</a>, <a href="/generators/eleventy/">Eleventy</a>, <a href="/generators/next/">NextJS</a>, <a href="/generators/">and very many more</a>, many web developers are already familiar with the tools needed to become productive Jamstack developers.
   </p>
 </section>
-<section class="mb-12 pb-20 border-gray-400 border-b ">
+<section>
   <h2>Enhancing with JavaScript</h2>
   <p>
-    With the <a href="/glossary/markup">markup</a> and other user interface assets of Jamstack sites served directly from a CDN, they can be delivered very quickly and securely. On this foundation, Jamstack sites can use JavaScript and APIs to talk to backend services, allowing experiences to be enhanced and personalized.
+    With the <a href="/glossary/markup/">markup</a> and other user interface assets of Jamstack sites served directly from a CDN, they can be delivered very quickly and securely. On this foundation, Jamstack sites can use JavaScript and APIs to talk to backend services, allowing experiences to be enhanced and personalized.
+  </p>
+</section>
+<section class="mb-12 pb-20 border-gray-400 border-b ">
+  <h2>Supercharging with services</h2>
+  <p>
+    The thriving <a hred="/glossary/api-economy/">API economy</a> has become a significant enabler for Jamstack sites. The ability to leverage domain experts who offer their products and service via APIs has allowed teams to build for more complex applications than if they were to take on the risk and burden of such capabilities themselves. Now we can outsource things like authentication and identity, payments, content management, data services, search, and much more.
+    </p>
+  <p>
+    Jamstack sites might utilise such services at build time, and also at run time directly from the browser via JavaScript. And the clean <a href="/glossary/decoupling/">decoupling</a> of these services allows for greater portability and flexibility, as well as significanlty reduced risk.
   </p>
 </section>
 <section class="mb-20 pb-20 border-gray-400 border-b ">
   <h2>Named to help the conversation</h2>
   <p>
-    The name "Jamstack" came about because as Matt Biilmann and Chris Bach were creating modern web development workflows and capabilities at Netlify, they found there was no easy way to refer to the architectural approach in conversation. Jamstack embraces many existing fundamentals of web architectures, and so they created the term Jamstack to help us talk about it more succinctly.
+    The name "Jamstack" came about because as Matt Biilmann and Chris Bach were creating modern web development workflows and capabilities at <a href="https://netlify.com">Netlify</a>, they found there was no easy way to refer to the architectural approach in conversation. Jamstack embraces many existing fundamentals of web architectures, and so they created the term Jamstack to help us talk about it more succinctly.
   </p>
   <p>
     You can learn more about the background, benefits, and case studies of Jamstack in the book <a href="https://www.netlify.com/oreilly-jamstack/">Modern web development on the Jamstack</a>, (Biilmann & Hawksworth, O'Reilly, 2019)

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>