Studio/overview docs (#1293)

* Basic overview of Studio

* updates to getting-started for create-app

* oppdatere lenke

* fix bad links

content/altinn-studio/_index.en.md

@@ -0,0 +1,10 @@
+---
+title: Altinn Studio
+description: Altinn Studio - Your tool for developing digital services for citizens and businesses
+aliases:
+- /altinn-studio/
+- /technology/altinnstudio/solutions/altinn-studio/
+weight: 1
+---
+
+{{<children />}}

content/altinn-studio/_index.nb.md

@@ -0,0 +1,10 @@
+---
+title: Altinn Studio
+description: Altinn Studio - Ditt verktøy for utvikling av digitale tjenester til innbyggere og næringsliv
+aliases:
+- /nb/altinn-studio/
+- /nb/teknologi/altinnstudio/solutions/altinn-studio/
+weight: 1
+---
+
+{{<children />}}

content/altinn-studio/about/_index.en.md

@@ -0,0 +1,79 @@
+---
+title: About Altinn Studio
+description: High-level description of Altinn Studio
+aliases:
+- /altinn-studio/
+- /technology/altinnstudio/solutions/altinn-studio/
+weight: 1
+---
+
+Altinn Studio is a tool for efficiently realizing digital services. We offer:
+- a web-based tool for creating and testing services (apps) - Altinn Studio Designer
+- a template for services with standard functionality and the ability to add custom functionality
+- a dedicated environment for each service owner to run the services (testing and production)
+- a set of common support functions to assist services, e.g., PDF receipt generation, notifications, etc.
+
+## What can I create with Altinn Studio?
+
+### Form services
+Traditional forms where the user fills in and submits data on behalf of themselves or others, possibly their business.
+
+### Inspection services
+Services where a form is not submitted, but only a request for insight into existing data.
+
+### Guide
+Services that guide the user through a process to provide an answer or the right starting point for the way forward.
+This type of service also supports users who are not logged in.
+
+### Coordinated services *
+Services that typically consist of multiple forms, subprocesses, multiple users, and integrations with other agencies.
+
+{{% notice info %}}
+\* Although it is possible to create this type of service today, we are working to make it easier to implement this type 
+of service by moving more functionality into the web tool.
+{{% /notice %}}
+
+## Altinn Studio is the "connector"
+A form is rarely just data fields to be submitted; more is needed to create a good service – e.g., connection
+to ID-porten, submission to the case processing system via eFormidling, or connection to national registers.
+
+Altinn Studio has pre-developed integrations with several of Digdir's shared services and national registers, and will
+continue to develop and add more.
+
+![Altinn Studio is the "connector"](./studio-i-midten.png "Altinn Studio is the connector")
+
+## Low-code and traditional code
+Altinn Studio is a hybrid between low-code and traditional coding. This means you can start with low-code in Altinn Studio
+Designer and switch to dedicated development tools like Visual Studio Code if you have advanced needs that require coding.
+
+Our goal is to do as much as possible with low-code but retain the option for traditional coding and the flexibility
+it provides. This allows non-technical resources to design and publish services without the need to involve developers.
+At the same time, a developer can be brought in to create more advanced functionality that requires coding.
+
+![The tool supports both low-code and traditional coding](./nocode_vs_coding.png "The tool supports both low-code and traditional coding")
+
+## Principles that Altinn Studio is built on
+Here are some of the principles underlying our development of Altinn Studio.
+- **Free and open-source code** because we genuinely believe that openness and the opportunity for others to contribute is the way to go for developing services in the public sector.
+- **Based on open standards** because closed code ties you to a supplier and often entails additional costs.
+- **Cloud-based infrastructure** where loose connections are sought without binding to a specific cloud provider.
+- **Built on modern and popular frameworks/products** because it makes it easier for both us and our customers to acquire technical resources and because it's something one wants to work with/learn.
+- **Embedded security** where each layer in the architecture authorizes use regardless of where the calls come from.
+- **Isolation** – Service owners get their own environments for testing and production.
+
+### Open source and collaboration
+Altinn Studio is not perfect, but it takes you a long way in creating good digital services - and we continuously add new functionality.
+
+Instead of creating something on your own or buying something – why not contribute to the open-source project where there may be gaps
+and thus give something back to the community?
+The Altinn Studio teams handle quality assurance and ongoing code management.
+
+Creating an environment around the development of services is important to us, and we now have a good number of contributors from
+many public agencies contributing to advancing the product with us.
+Contributions range from fixing typos that take seconds to fix to major components that have taken months.
+
+An important part of creating an environment is the developer contact we have via Altinn Slack. Each service owner has their own
+channel where questions can be asked.
+We also see that service owners help each other and share experiences across organizations.
+Backlog, user stories, plans, and roadmaps – everything is openly available on GitHub, providing both insight
+and comments.

content/altinn-studio/about/_index.nb.md

@@ -0,0 +1,83 @@
+---
+title: Om Altinn Studio
+description: Overordnet beskrivelse av Altinn Studio
+aliases:
+- /nb/altinn-studio/
+- /nb/teknologi/altinnstudio/solutions/altinn-studio/
+weight: 1
+---
+
+Altinn Studio er et verktøy for å effektivt realisere digitale tjenester. Vi tilbyr:
+- et web basert verktøy for å lage og teste tjenester (apper) - Altinn Studio Designer
+- en mal for tjenester med standard funksjonalitet og mulighet for å legge til egen funksjonalitet
+- ett dedikert miljø for hver tjenesteeier for kjøring av tjenestene (test og produksjon)
+- ett sett med felles støttefunksjoner for å understøtte tjenestene, f.eks. generering av PDF kvittering, varsling, osv.
+
+
+## Hva kan jeg lage med Altinn Studio?
+
+### Skjematjenester
+Tradisjonelle skjemaer hvor brukeren fyller inn og sender inn data på vegne av seg selv eller andre, ev. sin bedrift.
+
+### Innsynstjenester
+Tjenester hvor man ikke sender inn et skjema, men kun ber om innsyn i eksisterende data.
+
+### Veileder
+Tjenester som veileder brukeren gjennom en prosess for å kunne gi et svar eller rett utgangspunkt for veien videre.
+Denne typen tjeneste støtter også brukere som ikke har logget inn.
+
+### Sammenhengende tjenester *
+Tjenester som typisk består av flere skjema, delprosesser, flere brukere, og integrasjoner med andre etater.
+
+{{% notice info %}}
+\* Selv om det er mulig å lage denne tjenestetypen i dag, jobber vi med å gjøre det enklere å implementere denne 
+typen tjeneste ved å flytte mer funksjonalitet inn i web verktøyet.
+{{% /notice %}}
+
+## Altinn Studio er "bindemiddelet"
+Et skjema er sjelden bare datafelter som skal sendes inn, det trengs mer for å lage en god tjeneste – f.eks. kobling 
+mot ID-porten, innsending til saksbehandlingssystem via eFormidling eller kobling mot nasjonale registre.
+
+Altinn Studio har ferdig utviklet integrasjoner mot flere av Digdir sine fellestjenester og nasjonale registre, og vil 
+fortsette å utvikle disse og legge til flere.
+
+![Altinn Studio er "bindemiddelet"](./studio-i-midten.png "Altinn Studio er bindemiddelet")
+
+## Lavkode og tradisjonell kode
+Altinn Studio er en hybrid mellom lavkode og tradisjonell koding. Det betyr at du kan starte med lavkode i Altinn Studio
+Designer, og bytte over til dedikerte utviklingsverktøy som Visual Studio Code om du har avanserte behov som trenger
+koding.
+
+Vårt mål er å kunne gjøre mest mulig med lavkode, men beholde mulighet for tradisjonell koding og den fleksibiliteten 
+det gir. Dette gjør at ikke-tekniske ressurser kan designe og publisere tjenester uten at man må hente inn utviklere.
+Samtidig kan man hente inn en utvikler for å lage f.eks. mer avansert funksjonalitet som krever koding.
+
+![Verktøyet støtter både lavkode og tradisjonell koding](./nocode_vs_coding.png "Verktøyet støtter både lavkode og tradisjonell koding")
+
+
+## Prinsipper som Altinn Studio bygger på
+Her lister vi noen av prinsippene som ligger til grunn for vår utvikling av Altinn Studio.
+- **Fri og åpen kildekode** fordi vi genuint tror at åpenhet og mulighet for andre til å bidra er veien å gå for utvikling av tjenester i offentlig sektor. 
+- **Basert på åpne standarder** fordi lukket kode binder deg til leverandør og medfører ofte ekstra kostnader. 
+- **Skybasert infrastruktur** hvor man tilstreber løse koblinger uten binding mot en spesifikk skyleverandør. 
+- **Bygges på moderne og populære rammeverk/produkter** fordi det gjør det lettere både for oss og våre kunder å skaffe tekniske ressurser og fordi det er noe man ønsker å jobbe med/lære seg.
+- **Innebygd sikkerhet** hvor hvert lag i arkitekturen autoriserer bruken uavhengig av hvor kallene kommer fra.
+- **Isolasjon** – Tjenesteeiere får sine egne miljøer, for test og produksjon.
+
+### Åpen kildekode og samarbeid
+Altinn Studio er ikke perfekt, men det tar deg et langt stykke på vei for å lage gode digitale tjenester - og vi legger 
+kontinuerlig til ny funksjonalitet.
+
+I stedet for å lage noe eget eller kjøpe noe – hvorfor ikke bidra til åpen kildekode prosjektet der det ev. er mangler 
+og på den måten gi noe tilbake til samfunnet?
+Altinn Studio teamene håndterer kvalitetssikring og videre forvaltning av koden.
+
+Det å skape et miljø rundt utviklingen av tjenester er viktig for oss, og vi har nå en et godt antall bidragsytere fra 
+mange offentlige etater som bidrar til å løfte produktet videre sammen med oss.
+Bidrag er alt fra retting av skrivefeil som tar sekunder å fikse til store komponenter som har tatt måneder.
+
+En viktig del av det å skape et miljø er den utviklerkontakten vi har via Altinn Slack. Hver tjenesteeier har sin egen 
+kanal hvor man kan stille spørsmål.
+Vi ser også at tjenesteeiere hjelper hverandre og deler erfaring på tvers.
+Backlog, brukerhistorier, planer og veikart – alt ligger åpen tilgjengelig på GitHub og gir mulighet for både innsikt 
+og kommentarer.

content/altinn-studio/architecture/_index.md

@@ -3,6 +3,7 @@ title: Application construction components Altinn Studio
 linktitle: Architecture
 description: The application construction components for Altinn Studio includes all components uses to create the Altinn Studio Applications.
 weight: 99999
+hidden: true
 ---
 
 The following diagram shows the application construction construction for the Altinn Studio solution with its applications.

content/altinn-studio/designer/_index.en.md

@@ -0,0 +1,8 @@
+---
+title: Toolkits in Altinn Studio
+linktitle: Toolkits
+description: Information about Altinn Studios web tools for building digital services
+weight: 10
+--- 
+
+{{<children />}}

content/altinn-studio/designer/_index.nb.md

@@ -0,0 +1,8 @@
+---
+title: Altinn Studio Designer
+linktitle: Verktøy
+description: Informasjon om Altinn Studios webverktøy for utvikling av tjenester
+weight: 10
+--- 
+
+{{<children />}}

content/altinn-studio/designer/build-app/_index.en.md

@@ -2,10 +2,7 @@
 title: Building and configuring apps
 linktitle: Building apps
 description: Altinn Studio can been seen as a collection of different editors or applications specialized to create and edit different aspects of an Altinn Studio app.
-weight: 2
+weight: 1
 ---
 
-To support building apps Altinn Studio have different functionality to building and configuring different aspects of the
-app.
-
 {{<children />}}

content/altinn-studio/designer/build-app/_index.nb.md

@@ -0,0 +1,8 @@
+---
+title: Verktøy for tjenesteutvikling
+linktitle: Tjenesteutvikling
+description: Altinn Studio har flere verktøy som kan brukes til å utvikle digitale tjenester. Klikk inn på hver enkelt område for å lese mer.
+weight: 1
+---
+
+{{<children />}}

content/altinn-studio/designer/build-app/api-expose/_index.en.md

@@ -2,6 +2,7 @@
 title: API
 description: Apps created in Altinn Studio exposes standard APIS and you can add custom API.
 tags: [api]
+hidden: true
 ---
 
 Each app will have its unique set of APIs. Compared to current API it makes it possible to create APIs that

content/altinn-studio/designer/build-app/app-parameters/_index.en.md

@@ -1,11 +1,11 @@
 ---
-title: App Parameters
-description: The application contains different parameters that control the behavior.
-weight: 1
+title: Settings
+description: Settings for the service can be configured
+weight: 6
 ---
 
-You can configure the different parameters either in Altinn Studio UI or by modifying the configuration files in the application repository.
-
-![Config](config.jpg)
-
-See the complete overview of different configurations in the [application development handbook.](../../../../../../app/development/configuration/)
+Settings can be configured at the service level, i.e., settings that apply to the entire service. Examples may include:
+- Whether data should be deleted after submission
+- Whether a list of ongoing instances should be shown to the user when they open the service
+- Whether the service should be hidden from the user's inbox in Altinn
+- Whether it should be possible to create a new copy of the service based on a previous submission

content/altinn-studio/designer/build-app/app-parameters/_index.nb.md

@@ -0,0 +1,12 @@
+---
+title: Innstillinger
+description: Innstillinger på tjenesten kan konfigureres
+weight: 6
+---
+
+Man kan konfigurere innstillinger på tjenestenivå, dvs. innstillinger som gjelder for hele tjenesten.
+Eksempler kan være:
+- Om dataene skal slettes etter innsending
+- Om en liste med påbegynte instanser skal vises til brukeren når de åpner tjenesten
+- Om tjenesten skal skjules fra brukerens innboks i Altinn
+- Om det skal gå an å opprette en ny kopi av tjenesten basert på tidligere innsending

content/altinn-studio/designer/build-app/authorization-rules/_index.en.md

@@ -1,14 +1,14 @@
 ---
-title: Defining authorization policies
-linktitle: Authorization
-description: Altinn Studio lets the developer set the authorization requirements for an App.
+title: Access Control
+linktitle: Access Control
+description: Tools for configuring access control (authorization) on a service
+weight: 5
 ---
 
-An app needs to have defined an Authorization Policy that will be imported into Policy Retrieval Point when deployed to an Altinn Apps/Platform environment.
+- Access control at the role, person, and organizational levels
+- Access control for the entire, or parts of, the process
+- Delegation of forms
+- Defining trust levels on the service
+- Setting actor requirements on the service
 
-The policy format follows XACML 3.0, and for every policy rule, attributes define which resource, subject, and action it targets.
-
-Currently, Altinn Studio only supports manual editing of XACML XML.
-Later Altinn will add a UI to define the policy in the future.
-
-Read how to define Authorization Policy in the [Application Developer Handbook.](/app/development/configuration/authorization/)
+![Access control](./policy-editor.png "Access control")

content/altinn-studio/designer/build-app/authorization-rules/_index.nb.md

@@ -0,0 +1,14 @@
+---
+title: Tilgangsstyring
+linktitle: Tilgangsstyring
+description: Verktøy for å konfigurere tilgangsstyring på en tjeneste
+weight: 5
+---
+
+- Tilgangsstyring på rolle, person og organisasjonsnivå
+- Tilgangsstyring av hele, eller deler av, prosessen
+- Delegering av skjema
+- Definere tillitsnivå på tjenesten
+- Sette aktørkrav på tjenesten
+
+![Tilgangsstyring](./policy-editor.png "Tilgangsstyring")