Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Clarify language and defintions
  • Loading branch information
philhawksworth committed Dec 11, 2019
1 parent d984d9b commit 41c0b76
Show file tree
Hide file tree
Showing 15 changed files with 324 additions and 284 deletions.
10 changes: 5 additions & 5 deletions README.md
@@ -1,6 +1,6 @@
# JAMstack
# Jamstack

This is the small start of something. The JAMstack homepage with a few lines about the concepts and the philosophy.
This is the small start of something. The Jamstack homepage with a few lines about the concepts and the philosophy.

Over time this will hopefully grow into a useful entry-point for learning about this new stack, sharing tools, tips and best practices as well as spreading the word.

Expand Down Expand Up @@ -30,15 +30,15 @@ yarn build

## Contribute Resources (Videos & Articles)

To contribute resources to the JAMstack community, simply clone this branch and edit the `resources.yaml` in the `/site/data` directory. Just add another item (following the the prexisting syntax) and submit a pull request. If you are adding a video resource, please upload a thumbnail of the video to the `/img/videos` directory (image should be a jpeg 600px wide and 400px tall) before submitting your pull request. We will review these regularly and likely merge the addition shortly.
To contribute resources to the Jamstack community, simply clone this branch and edit the `resources.yaml` in the `/site/data` directory. Just add another item (following the the prexisting syntax) and submit a pull request. If you are adding a video resource, please upload a thumbnail of the video to the `/img/videos` directory (image should be a jpeg 600px wide and 400px tall) before submitting your pull request. We will review these regularly and likely merge the addition shortly.

## Contribute Examples

To contribute examples to the JAMstack community, simply clone this branch and edit the `examples.yaml` in the `/site/data` directory. Just add another item (following the the prexisting syntax). Lastly, upload a thumbnail of the site to the `/img/examples` directory (image should be a jpeg 596px wide and 396px tall) and submit a pull request. We will review these regularly and likely merge the addition shortly.
To contribute examples to the Jamstack community, simply clone this branch and edit the `examples.yaml` in the `/site/data` directory. Just add another item (following the the prexisting syntax). Lastly, upload a thumbnail of the site to the `/img/examples` directory (image should be a jpeg 596px wide and 396px tall) and submit a pull request. We will review these regularly and likely merge the addition shortly.

## Contribute Events

To contribute events to the JAMstack community, we recommend just adding the event to your meetup and let our logic do the rest. If the event is outside of a meetup (like a conference), please manually submit it using the short guide below:
To contribute events to the Jamstack community, we recommend just adding the event to your meetup and let our logic do the rest. If the event is outside of a meetup (like a conference), please manually submit it using the short guide below:

1. Clone this branch and edit the `events.yaml` in the `/site/data` directory
2. Add your event (following the the prexisting syntax)
Expand Down
4 changes: 2 additions & 2 deletions site/config.yaml
@@ -1,7 +1,7 @@
baseurl: DEPLOY_PRIME_URL
languageCode: "en-us"
title: "JAMstack | JavaScript, APIs, and Markup"
title: "Jamstack | JavaScript, APIs, and Markup"
disableKinds: ["404"]
metaDataFormat: "yaml"

publishDir: "dist"
publishDir: "dist"
8 changes: 4 additions & 4 deletions site/data/bestpractices.yaml
@@ -1,15 +1,15 @@
---
bestpractices:
- title: Entire Project on a CDN
description: Because JAMstack projects don’t rely on server-side code, they can be distributed instead of living on a single server. Serving directly from a CDN unlocks speeds and performance that can't be beat. The more of your app you can push to the edge, the better the user experience.
description: Because Jamstack projects don’t rely on server-side code, they can be distributed instead of living on a single server. Serving directly from a CDN unlocks speeds and performance that can't be beat. The more of your app you can push to the edge, the better the user experience.
- title: Everything Lives in Git
description: With a JAMstack project, anyone should be able to do a `git clone`, install any needed dependencies with a standard procedure (like `npm install`), and be ready to run the full project locally. No databases to clone, no complex installs. This reduces contributor friction, and also simplifies staging and testing workflows.
description: With a Jamstack project, anyone should be able to do a `git clone`, install any needed dependencies with a standard procedure (like `npm install`), and be ready to run the full project locally. No databases to clone, no complex installs. This reduces contributor friction, and also simplifies staging and testing workflows.
- title: Modern Build Tools
description: Take advantage of the world of modern build tools. It can be a jungle to get oriented in and it's a fast moving space, but you'll want to be able to use tomorrow's web standards today without waiting for tomorrow's browsers. And that currently means Babel, PostCSS, Webpack, and friends.
- title: Automated Builds
description: Because JAMstack markup is prebuilt, content changes won’t go live until you run another build. Automating this process will save you lots of frustration. You can do this yourself with webhooks, or use a publishing platform that includes the service automatically.
description: Because Jamstack markup is prebuilt, content changes won’t go live until you run another build. Automating this process will save you lots of frustration. You can do this yourself with webhooks, or use a publishing platform that includes the service automatically.
- title: Atomic Deploys
description: As JAMstack projects grow really large, new changes might require re-deploying hundreds of files. Uploading these one at a time can cause inconsistent state while the process completes. You can avoid this with a system that lets you do "atomic deploys," where no changes go live until all changed files have been uploaded.
description: As Jamstack projects grow really large, new changes might require re-deploying hundreds of files. Uploading these one at a time can cause inconsistent state while the process completes. You can avoid this with a system that lets you do "atomic deploys," where no changes go live until all changed files have been uploaded.
- title: Instant Cache Invalidation
description: When the build-to-deploy cycle becomes a regular occurrence, you need to know that when a deploy goes live, it really goes live. Eliminate any doubt by making sure your CDN can handle instant cache purges.
---
134 changes: 67 additions & 67 deletions site/data/community.yaml
@@ -1,142 +1,142 @@
chapters:
- name: JAMstack San Francisco
- name: Jamstack San Francisco
artpath: /img/chapters/sf-art.svg
btncopy: Join Now
link: https://www.meetup.com/jamstack-sf/
- name: JAMstack Austin
link: https://www.meetup.com/Jamstack-sf/
- name: Jamstack Austin
artpath: /img/chapters/austin-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Austin/
- name: JAMstack Boston
link: https://www.meetup.com/Jamstack-Austin/
- name: Jamstack Boston
artpath: /img/chapters/boston-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Boston/
- name: JAMstack Porto
link: https://www.meetup.com/Jamstack-Boston/
- name: Jamstack Porto
artpath: /img/chapters/porto-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Porto/
- name: JAMstack NYC
link: https://www.meetup.com/Jamstack-Porto/
- name: Jamstack NYC
artpath: /img/chapters/nyc-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-nyc/
- name: JAMstack London
link: https://www.meetup.com/Jamstack-nyc/
- name: Jamstack London
artpath: /img/chapters/london-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-London/
- name: JAMstack Berlin
link: https://www.meetup.com/Jamstack-London/
- name: Jamstack Berlin
artpath: /img/chapters/berlin-illo.svg
btncopy: Join Now
link: https://www.meetup.com/JAMStack_berlin/
- name: JAMstack Wrocław
link: https://www.meetup.com/Jamstack_berlin/
- name: Jamstack Wrocław
artpath: /img/chapters/wroclaw-illo.svg
btncopy: Join Now
link: https://www.meetup.com/JAMStack-Wroclaw/
- name: JAMstack Portland
link: https://www.meetup.com/Jamstack-Wroclaw/
- name: Jamstack Portland
artpath: /img/chapters/portland-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Portland/
- name: JAMstack Hamburg
link: https://www.meetup.com/Jamstack-Portland/
- name: Jamstack Hamburg
artpath: /img/chapters/hamburg-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Hamburg/
- name: JAMstack Bengaluru
link: https://www.meetup.com/Jamstack-Hamburg/
- name: Jamstack Bengaluru
artpath: /img/chapters/bengaluru-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Bengaluru/
- name: JAMstack Paris
link: https://www.meetup.com/Jamstack-Bengaluru/
- name: Jamstack Paris
artpath: /img/chapters/paris-art.svg
btncopy: Join Now
link: https://www.meetup.com/fr-FR/JAMstack-paris/
- name: JAMstack Seattle
link: https://www.meetup.com/fr-FR/Jamstack-paris/
- name: Jamstack Seattle
artpath: /img/chapters/seattle-art.svg
btncopy: Join Now
link: https://www.meetup.com/jamstack-seattle/
- name: JAMstack Tokyo
link: https://www.meetup.com/Jamstack-seattle/
- name: Jamstack Tokyo
artpath: /img/chapters/tokyo-art.svg
btncopy: Join Now
link: https://jamstack-tokyo.connpass.com/
- name: JAMstack Lisbon
link: https://Jamstack-tokyo.connpass.com/
- name: Jamstack Lisbon
artpath: /img/chapters/lisbon-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Lisbon/
- name: JAMstack Istanbul
link: https://www.meetup.com/Jamstack-Lisbon/
- name: Jamstack Istanbul
artpath: /img/chapters/istanbul-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack/
- name: JAMstack Oslo
link: https://www.meetup.com/Jamstack/
- name: Jamstack Oslo
artpath: /img/chapters/oslo-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Oslo/
- name: JAMstack Atlanta
link: https://www.meetup.com/Jamstack-Oslo/
- name: Jamstack Atlanta
artpath: /img/chapters/atlanta-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMStack-Atlanta/
- name: JAMstack Cincinnati
link: https://www.meetup.com/Jamstack-Atlanta/
- name: Jamstack Cincinnati
artpath: /img/chapters/cincinnati-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Cincinnati/
- name: JAMstack Phoenix
link: https://www.meetup.com/Jamstack-Cincinnati/
- name: Jamstack Phoenix
artpath: /img/chapters/phoenix-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack_PHX/
- name: JAMstack Minsk
link: https://www.meetup.com/Jamstack_PHX/
- name: Jamstack Minsk
artpath: /img/chapters/minsk-art.svg
btncopy: Join Now
link: https://www.meetup.com/ru-RU/JAMstack-Minsk/
- name: JAMstack Chicago
link: https://www.meetup.com/ru-RU/Jamstack-Minsk/
- name: Jamstack Chicago
artpath: /img/chapters/chicago-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Chicago/
- name: JAMstack Lagos
link: https://www.meetup.com/Jamstack-Chicago/
- name: Jamstack Lagos
artpath: /img/chapters/lagos-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMStack-Lagos/
- name: JAMstack Denver
link: https://www.meetup.com/Jamstack-Lagos/
- name: Jamstack Denver
artpath: /img/chapters/denver-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Denver/
- name: JAMstack Israel
link: https://www.meetup.com/Jamstack-Denver/
- name: Jamstack Israel
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMStack-IL/
- name: JAMstack Yemen
link: https://www.meetup.com/Jamstack-IL/
- name: Jamstack Yemen
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.facebook.com/groups/JAMstackYemenMeetups
- name: JAMstack Florence
link: https://www.facebook.com/groups/JamstackYemenMeetups
- name: Jamstack Florence
artpath: /img/chapters/florence-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack_Florence/
- name: JAMstack Detroit
link: https://www.meetup.com/Jamstack_Florence/
- name: Jamstack Detroit
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Detroit/
- name: JAMstack Singapore
link: https://www.meetup.com/Jamstack-Detroit/
- name: Jamstack Singapore
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Singapore/
- name: JAMstack Abuja
link: https://www.meetup.com/Jamstack-Singapore/
- name: Jamstack Abuja
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.meetup.com/JAMstack-Abuja/
- name: JAMstack Philadelphia
link: https://www.meetup.com/Jamstack-Abuja/
- name: Jamstack Philadelphia
artpath: /img/chapters/philadelphia-art.svg
btncopy: Join Now
link: http://meetup.com/JAMstack-Philly/
- name: JAMstack Ulaanbaatar
link: http://meetup.com/Jamstack-Philly/
- name: Jamstack Ulaanbaatar
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://www.facebook.com/groups/JAMstackUlaanbaatar/
- name: JAMstack Warri
link: https://www.facebook.com/groups/JamstackUlaanbaatar/
- name: Jamstack Warri
artpath: /img/chapters/placeholder-art.svg
btncopy: Join Now
link: https://m.facebook.com/groups/473905470150140

slackurl: https://jamstack.org/slack
slackurl: https://Jamstack.org/slack
forumurl: https://community.netlify.com

bottomcta:
artpath: /img/chapters/meetup-map.svg
headline: Start a JAMstack Meetup
headline: Start a Jamstack Meetup
ctacopy: Contact Us
ctalink: mailto:community@netlify.com
4 changes: 2 additions & 2 deletions site/data/definitions.yaml
@@ -1,6 +1,6 @@
---
jamstack: "A modern architecture —<br/>Create fast and secure sites and dynamic apps with **J**avaScript, **A**PIs, and prerendered **M**arkup, served without web servers."
explanation: When we talk about "The Stack," we no longer talk about operating systems, specific web servers, backend programming languages, or databases.<br><br>The JAMstack is not about specific technologies. It's a new way of building websites and apps that delivers better performance, higher security, lower cost of scaling, and a better developer experience.
jamstack: "Create fast and secure sites and dynamic apps with pre-rendered resources served directly from a CDN, removing the requirement to manage or run web servers."
explanation: When we talk about "The Stack," we no longer talk about operating systems, specific web servers, backend programming languages, or databases.<br><br>The Jamstack is not about specific technologies. It's a new way of building websites and apps that delivers better performance, higher security, lower cost of scaling, and a better developer experience.<br><br>Pre-rendered sites can be enhanced with JavaScript and the growing capabilities of browsers and services available via APIs.

javascript: "Any dynamic programming during the request/response cycle is handled by JavaScript, running entirely on the client. This could be any frontend framework, library, or even vanilla JavaScript."
apis: "All server-side processes or database actions are abstracted into reusable APIs, accessed over HTTPS with JavaScript. These can be custom-built or leverage third-party services."
Expand Down
4 changes: 2 additions & 2 deletions site/data/examples.yaml
Expand Up @@ -116,7 +116,7 @@ examples:
- tool: Progressive Web App
- tool: Google Analytics
- title: DUSK
description: DUSK is a creative collective agency for web design, development, strategy & branding built on jekyll using the JAMstack and Netlify CMS for content management.
description: DUSK is a creative collective agency for web design, development, strategy & branding built on jekyll using the Jamstack and Netlify CMS for content management.
link: https://www.duskdigital.co/
thumbnailurl: /img/examples/dusk.jpg
tools:
Expand Down Expand Up @@ -381,4 +381,4 @@ examples:
- tool: Azure Pipelines
- tool: Azure Container Registry
- tool: Azure Storage Static Website
- tool: Docker
- tool: Docker
22 changes: 11 additions & 11 deletions site/data/resources.yaml
@@ -1,37 +1,37 @@
---
articles:
- title: How to Build a JAMstack Website
- title: How to Build a Jamstack Website
link: https://cosmicjs.com/blog/how-to-build-a-jamstack-website
- title: A JAMstack-ready CMS
- title: A Jamstack-ready CMS
link: https://www.contentful.com/r/knowledgebase/jamstack-cms/
- title: Isomorphic Rendering on the JAMstack
- title: Isomorphic Rendering on the Jamstack
link: https://www.hawksworx.com/blog/isomorphic-rendering-on-the-jam-stack/
- title: Dynamic product management in a static e-commerce workflow
link: https://www.contentful.com/blog/2016/02/10/snipcart-middleman-contentful
- title: "JAMstack for Clients: On Benefits & Static Site CMS"
- title: "Jamstack for Clients: On Benefits & Static Site CMS"
link: https://snipcart.com/blog/jamstack-clients-static-site-cms
- title: "Go static: 5 reasons to try JAMstack on your next project"
- title: "Go static: 5 reasons to try Jamstack on your next project"
link: https://builtvisible.com/go-static-try-jamstack/
- title: "Zero to HTTP/2 with AWS and Hugo"
description: A step-by-step guide to creating your own JAMstack site using Amazon Web Services and the Hugo static site generator.
description: A step-by-step guide to creating your own Jamstack site using Amazon Web Services and the Hugo static site generator.
link: https://habd.as/zero-to-http-2-aws-hugo/
- title: "Static Websites + JAMstack = <3"
- title: "Static Websites + Jamstack = <3"
link: https://julian.is/article/static-websites-and-jamstack/
- title: "What is JAMstack and why you should try it"
- title: "What is Jamstack and why you should try it"
link: https://www.giftegwuenu.com/what-is-jamstack-and-why-you-should-try-it/
- title: "Introducing JAMstack: The Modern Web Architecture"
- title: "Introducing Jamstack: The Modern Web Architecture"
link: https://www.bolajiayodeji.com/introducing-jamstack-the-modern-web-architecture/

videos:
- title: Rise of the JAMstack
- title: Rise of the Jamstack
description: The emergence of Git centered workflows, around modern build tools, static site generators, and modern browsers, have changed the way most front-enders work.
link: https://www.youtube.com/watch?v=uWTMEDEPw8c
thumbnailurl: /img/videos/mathias-active-ingredients.jpg
- title: The New Front-end Stack. Javascript, APIs and Markup
description: Matt Biilmann covers how a new stack has emerged and how this has changed how web sites and web apps are built.
link: https://vimeo.com/163522126
thumbnailurl: /img/videos/mathias-smashing-conf.png
- title: Easy Isomorphic Rendering on the JAMstack
- title: Easy Isomorphic Rendering on the Jamstack
description: In this talk, Phil explores some techniques and tools which can combine to create dynamic and powerful sites with on a JAM Stack.
link: https://www.youtube.com/watch?v=lRg99MH6rhw
thumbnailurl: /img/videos/isomorphic.jpg
Expand Down

0 comments on commit 41c0b76

Please sign in to comment.