wip

Author: jhrv

docs/explanation/environment.md

@@ -0,0 +1,8 @@
+# The runtime environment
+
+NAIS offers multiple environments for you to run your workloads.
+
+- i en organisasjon fins det typisk flere miljøer (f.eks dev og prod)
+- hvert miljø deles av alle teamene, og hvert team har sitt eget isolerte område / namespace der de kjører sine ting
+- teamene kan kommunisere seg i mellom innad i et miljø, gitt riktige tilganger (TODO: how-to access policy) eller zero-trust explanation
+- hvert miljø har et sett med ingresser/domener som kan benyttes for å eksponere tjenester

docs/explanation/workloads/README.md

@@ -5,10 +5,10 @@ At the core of NAIS, is the ability to run the code you write.
 Below is a list of the different kinds we support.
 
 ## NAIS application
-A [NAIS application](../reference/application-example.md) is a used for long-running processes such as a API.
+A [NAIS application](./application.md) is a used for long-running processes such as a API.
 
 ## NAIS job
-A [NAIS job](../reference/job-example.md) is used for tasks meant to complete and then exit. This can either run as a one-off task or on a schedule.
+A [NAIS job](./job.md) is used for tasks meant to complete and then exit. This can either run as a one-off task or on a schedule. 
 
 ## NAIS CDN
-[NAIS CDN](../reference/frontend-example.md) offers a way to serve static content and single-page applications (SPA).
+[NAIS CDN](./cdn.md) offers a way to serve static content and single-page applications (SPA).

docs/explanation/workloads/application.md

@@ -1,6 +1,10 @@
 # Application
-A [NAIS application](../../reference/application-example.md) is a long-running service that is expected to be available at all times. Such as a web server, a REST API, or a message queue consumer.
 
+A [NAIS application](../../reference/application-example.md) lets you run one or more instances of a container image. 
+
+An application is defined by its [application manifest](../../reference/application-spec.md), which is a YAML file that describes how the application should be run and what resources it needs.
+
+- autoskalering
 - kontrakt mellom applikasjon og plattform
 - en eller fler kjørende instanser av en container-image
 - default isolert