in progess..

docs/20-Requirement-management/requirement-specification.md

@@ -38,56 +38,56 @@ Topics in order of appearance
 1. [Relevant Use Cases]()
 1. [Key General Features / Functionalities]()
 1. [MockUp Prototype]()
-1. [Preliminary User Stories] (# Preliminary User Stories)
-1. [Service System Requirements] (# Service System Requirements)
-1. [Restrictions Affecting the Service] (# Restrictions Affecting the Service)
-1. [Service Related Equipment Requirements] (# Service Related Equipment Requirements)
-1. [Requirements related to the service execution environment] (# Requirements related to the service execution environment)
-1. [Service-defined features / functionalities] (# Service-defined features / functionalities)
-1. [Functional Requirements for the Service] (# Functional Requirements for the Service)
-1. [Non-functional requirements of the service] (# Non-functional requirements of the service)
-1. [Preliminary Service Architecture] (# Preliminary Service Architecture)
-1. [Preliminary Service Placement View] (# Preliminary Service Placement View)
-1. [Preliminary database description of the service)] (# Preliminary database description of the service)
-1. [Service Integrations with Other Systems] (# Service Integrations with Other Systems)
-1. [On Quality of Service Assurance] (# On Quality of Service Assurance)
-1. [Service Acceptance Tests] (# Service Acceptance Tests)
-1. [Publication plan] (# Publication plan)
-1. [Related Standards and Sources] (# Related Standards and Sources)
+1. [Preliminary User Stories]()
+1. [Service System Requirements]()
+1. [Restrictions Affecting the Service]()
+1. [Service Related Equipment Requirements]()
+1. [Requirements related to the service execution environment]()
+1. [Service-defined features / functionalities]()
+1. [Functional Requirements for the Service]()
+1. [Non-functional requirements of the service]()
+1. [Preliminary Service Architecture]()
+1. [Preliminary Service Placement View]()
+1. [Preliminary database description of the service)]()
+1. [Service Integrations with Other Systems]()
+1. [On Quality of Service Assurance]()
+1. [Release plan]()
+1. [Standards and Sources]()
 
 
-## Johdanto
+## Introduction
 
->Kuvaa millaisesta projektista on kyse, hieman taustaa ja aiheeseen olennaisesti liittyviä asioita? Jos kyseessä harjoitustehtävä, niin tarkista voitko 
-käytää todellisten tilaajien oikeita nimiä! Muuta tarvittaessa henkilötiedot ja toimeksiantajan viralliset tiedot
+>Describe what kind of project it is, a little background and things that are essentially related to the topic? If this is an exercise, then check if you can
+use the real names of the real subscribers! If necessary, change the personal data and the official data of the client
 
-## Toimeksiantaja
+## About client
 
->Kuka on vaatimusmäärittelyn tilaaja?
+>who is the client for the requirements specification?
 
-## Vaatimusmäärittelyn tekijästä
+## About Author
 
->Kerro lyhyesti itsestäsi (tarvittaessa pseudonyyminä) tai esim. kuvitteellisen yrityksen työntekijänä.
+>Tell about writer/author of 
 
-## Palvelukuvaus
+## Service Description
 
 [![](http://img.youtube.com/vi/55H2C0fSiHM/0.jpg)](http://www.youtube.com/watch?v=55H2C0fSiHM "")
 
->Mitä palvelun avulla voidaan tehdä? Millaisia ovat sen käyttäjät? Mikä sen tehtävä on yleisesti eri sidosryhmien kannalta? 
-Kannattaa nostaa esiin lyhyesti mahdolliset loppukäyttäjä ja oleellisiin palvelusta hyötyviin sidosryhmät
+>What can be done with the service? What are its users like? What is its role in general for the various stakeholders?
+It is worth highlighting briefly the potential end user and the relevant stakeholders who will benefit from the service
 
 
 
-## Sidosryhmäkartta
+## Stakeholder map
 
->Mietitään tarkemmin millaisia käyttäjä/sidosryhmiä liittyy suunniteltuun ohjelmisto/palvelukokonaisuuteen? 
-Näitä selkeyttääksemme kirjataan kaikki sidosryhmät sidosryhmäkartan muotoon. Nostetaan samalla esiin mikä on 
-ko. sidosryhmän/edustajan palveluun liittyvä motivaatio. Kuvauksen voi laatia esim. piirtämällä, MindMap-muodossa tai soveltaen sopivaa UML-notaatiota.
+> Consider in more detail what kind of user / stakeholders are involved in the planned software / service package?
+To clarify these, all stakeholders are recorded in the form of a stakeholder map. At the same time, let's highlight what is
+ko. motivation related to the service of the stakeholder / representative. The description can be created, for example, by drawing, in MindMap format or by applying a suitable UML notation.
 
 [![](http://img.youtube.com/vi/wiNjgClkJoM/0.jpg)](http://www.youtube.com/watch?v=wiNjgClkJoM "")
 
-> Voit tutustu nyt aiemmin mainittuun PlantUML-työkaluun ja kokeilla luoda sidosryhmäkartta käyttäen (http://plantuml.com/)
-> Huomaa! PlantUML-lohkon määrittelyssä käytetään Gitlab-ympäristössä eri avainsanoja @startuml/@enduml- rivien sijaan  
+> You can now check out the PlantUML tool mentioned earlier and try to create a stakeholder map (http://plantuml.com/)
+> Note! The PlantitL block is defined using different keywords in the Gitlab environment instead of @ startuml / @ enduml lines
+
 
 ```plantuml
 actor profile1
@@ -102,24 +102,24 @@ profile2 -- example_of_service  : benefits
 stake_holder1 -- example_of_service  : threat
 stake_holder2 -- example_of_service  : competitor
 ```
-> Voit kuvata sidosryhmät myös vapaamuotoisemmin, jolloin eri profiilien erot tulevat ehkä "selkeämmin" esiin!
+> You can also describe stakeholders more freely. Main purpose of description is to make visible differences between profiles clear to service developers
 
 ![](https://camo.githubusercontent.com/0d665c81987cc940b4d93c0dfdfcf0128d1d5754/68747470733a2f2f7777772e6c7563696463686172742e636f6d2f7075626c69635365676d656e74732f766965772f30303736373365342d333361362d346131312d623465312d6163366461633130306537352f696d6167652e706e67)
 
-## Sidosryhmät ja profiilit 
+## Stakeholders and profiles 
 
-> Määritellään tarkemmin hahmotellusta sidosryhmäkartasta oleelliset sidosryhmät/profiilit. Huomio, että isossa yksittäisessä sidosryhmässä voi 
-olla tarve määritellä useampia eri profiileja. Tämä tarkoittaa sitä, että laaja sidosryhmä, kuten esim. __asiakaskunta__ voi käsittää useita erilaisia asiakasprofiileja, 
-joilla voi olla eroja motiiveissa/arvoissa, mutta ne kuuluvat kuitenkin olennaisesti asiakaskuntaan.    
+> Relevant stakeholders / profiles are defined in more detail from the outlined stakeholder map. Note that a large individual stakeholder can
+there may be a need to define several different profiles. This means that a wide range of stakeholders, such as __customers__, can comprise several different customer profiles,
+which may have differences in motives / values, but which nevertheless belong essentially to the clientele.
 
 [![](http://img.youtube.com/vi/w5oXMtOGcC4/0.jpg)](http://www.youtube.com/watch?v=w5oXMtOGcC4 "")
 
-> Huomaa! Kaikki määritellyt profiilikuvaukset kirjoitetaan itsenäiseksi MarkDown-tiedostoksi, koska tämä helpottaa niihin viittaamista muualla dokumentaatiossa esim. [Loppukäyttäjä - Keijo Korhonen](profiili-loppukayttaja.md) 
-**Alla olevat profiili/sidosryhmätkuvaukset vain suuntaa antavia! Nimeä ne tarkoituksenmukaisiksi. Varmista, että ne ovat löydettävissä sidosryhmäkartasta!**
+> 
+Note! All defined profile descriptions are written as a standalone MarkDown file, as this makes it easier to refer to them elsewhere in the documentation, e.g. [End User  - Keijo Korhonen](profiili-enduser.md) 
 
-> Tässä kohtaa on aika etsiä profiilikuvauksen runkoa /pohjat kansiosta
+**The profile / stakeholder descriptions below are for guidance only! Name them appropriate. Make sure they can be found on the stakeholder map! **
 
-| Sidosryhmä/Profiili | Linkki |  Lisätietoa |
+| Stakeholder group/Specific profile| Description | About Motivation |
 |:-:|:-:|:-:|
 | Sidosryhmä 1 | [Sidosryhmä-1](pohjat/pohja-profiilikuvaus.md) | |
 | Sidosryhmä 2 | [Sidosryhmä-2](pohjat/pohja-profiilikuvaus.md) | |