From 844430b938aa857e8cbe5aa78582582ce33c0d89 Mon Sep 17 00:00:00 2001
From: ncastejon <castejon.nicolas@gmail.com>
Date: Fri, 23 Aug 2019 15:21:13 +0200
Subject: [PATCH] Add documentation for the web app

---
 docs/architecture/web-app.md |  24 ++++++++++++++++--------
 docs/assets/folders.png      | Bin 0 -> 37737 bytes
 2 files changed, 16 insertions(+), 8 deletions(-)
 create mode 100644 docs/assets/folders.png

diff --git a/docs/architecture/web-app.md b/docs/architecture/web-app.md
index f0db3da..8f31fb3 100644
--- a/docs/architecture/web-app.md
+++ b/docs/architecture/web-app.md
@@ -1,34 +1,42 @@
 ## Lyon Portal Open Data
 
 ## Files & Folders structure
+Organize a folders and files structure inside a project is never an easy task, and it exists many ways to do so.   
+We think that at the beginning we should just not overthink about it, choose one way to do it, keep to it, until a natural re-organization will happen if needed.   
+Here is our `/src` folder structure:
 
+![folers structure](../assets/folders.png)
+
+* `src/app`: where the Angular code is located. With time we organized this part in different modules taking care on one main functionnality each. Inside one module each component has its own folder with one `.ts`, one `.scss` and one `html` file.   
+* `/src/assets`: contains all the images, favicon, svg, fonts, Mapbox style files.
+* `src/environments`:
 
 
 ## CSS integration with Bulma
-For building the style on the portal, [Bulma](https://bulma.io/), a free and open source CSS framework based on Flexbox, has been used.  
+All the styling work has been done with [Bulma](https://bulma.io/), a free and open source CSS framework based on Flexbox, has been used.  
 It is highlighy customizable and easy to integrate in a project.
 
-To do so, a `variables.scss` file that contains our project variables, also overrides the Bulma variables (color, padding, anything you want). Then Bulma is imported and added to our main `style.scss`. That's it, our style incorporate a personalized Bulma .
+To do so, a `variables.scss` file that contains our project variables, overrides the Bulma variables (color, padding, anything you want). Then Bulma is imported and added to our main `style.scss`. That's it, our style incorporate a personalized Bulma .
 
 
 ## Research features
 This core feature is based on [Elasticsearch](https://www.elastic.co/fr/) (ES). Almost all the  information in the portal (including datasets, articles, geographical data) is indexed in ES. This allows lot's of possibilities with the powerful features of this tool.  
 Here are the features existing on the portal:
-* *research*: thanks to ES great indexation, to go through millions of documents is super fast (millions because we are not only look inside the metadata, but also inside the data)
+* *research*: thanks to ES great indexation, to go through millions of documents is super fast (millions because we are not only looking inside the metadata, but also inside the data)
 * *autocompletion*: using the score based on some criteria, we provides an autocompletion feature that helps to give a context for some research keywords.
-* *suggestion*: if a result didn't give good result (for example because of a typo), a word with more results will be suggested.
+* *suggestion*: if a research didn't give good or no results (for example because of a typo), a word with more results will be suggested.
 
 Of course there is a plenty of room for improvements for these features (and for new ones). ES is very powerful but also very complex to master. It's in a constant improvement.
 
 ## Map features
-For each dataset it's possible to display the data on a map. Here is what have been done to make this happen.  
+For each geographical dataset it's possible to display the data on a map. Here is what have been done to make this happen.  
 
 #### Mapbox GL JS
-On the client side, the library [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is used. This is very interesting tool improving quickly. The only drawback using it with Angular is because we need to wait the @types are updated. (it can have 2 or 3 versions of difference). 
+On the client side, the library [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is used. This is a very interesting tool improving quickly. The only drawback using it with Angular is that we cannot always use its last version. Indeed as we are using Typescript, we need to wait until the @types are updated.
 
 #### Styling
-Mapbox use a [Mapbox style specification](https://docs.mapbox.com/mapbox-gl-js/style-spec/) to define the visual appearance of a map.
-In our project we have created diffrent styles depending how we want to display the map. For example when we display the aerial layer, we don't necessary want the names of, say the roads and the river, have the same color than when we display the vectorial layer.  
+Mapbox use the [Mapbox style specification](https://docs.mapbox.com/mapbox-gl-js/style-spec/) to define the visual appearance of a map.
+In our project we have created different styles depending on how we want to display the map. For example when we display the aerial layer, we don't necessary want the names of, say the roads and the river, to have the same color than when we display the vectorial layer.  
 So when we change these layers, we load the appropriate style.
 
 #### How the data is fetched ?
diff --git a/docs/assets/folders.png b/docs/assets/folders.png
new file mode 100644
index 0000000000000000000000000000000000000000..db187bd0fc73dc96fc6daed0eda0c1c79daf7fb3
GIT binary patch
literal 37737
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
ARR910

literal 0
HcmV?d00001

-- 
GitLab