Merge pull request #5 from Fcmam5/NMA_First_feedback

NMA text fixes

website/docs/index.md

@@ -86,7 +86,7 @@ The survey was anonymous, we didn't collect any personal identifiable informatio
 
 ### Confidentiality & data usage
 
-Participation in the survey was entirely voluntary. All responses were kept confidential. No personally identifiable information were collected or disclosed in any reports or publications.
+Participation in the survey was entirely voluntary. All responses were kept confidential. No personal identifiable information was collected or disclosed in any reports or publications.
 
 All data was analyzed and reported in aggregate, ensuring that individual responses cannot be traced back to specific participants.
 
@@ -104,7 +104,7 @@ Data cleaning was done in serval phases:
 
 We ran a manual scan (yes, we went through 500+ lines of Excel) and flagged entries with 3 colors:
 
-1. 🟩 **Green**: Entries that seems coherent (e.g. age, years of experience, job title/level and salary) is reasonable.
+1. 🟩 **Green**: Entries that seems coherent e.g. age, years of experience, job title/level and salary are reasonable.
 2. 🟧 **Orange**: Entries that seem "odd", an exaggerated salary, or a high title for few years of experience, a long list of selected "used" technologies, etc.
 3. 🟥 **Red**: Entries that have conflicting data and it's clear that it's fake (for example we had an entry from a student who has 2 years of experience and who claimed that their salary is 2000000000 euros per year), or duplicated.
 
@@ -118,6 +118,6 @@ In this phase we clustered data to identify abnormal entries that we might misse
 
 #### 2. Cleaning pass 3: Interviewing experts and actors in Algerian tech industry
 
-Since data is unavailable or outdated, and our team is not working in the Algerian market.. It was only fair to run our findings through experts and personas who are working day-to-day in the Algerian tech industry.
+Since data is unavailable or outdated, and our team is not working in the Algerian market, It was only fair to run our findings through experts and personas who are working day-to-day in the Algerian tech industry.
 
 The experts and personas are defined in our [insights page](/docs/insights).

website/docs/insights/cloud-and-devops.md

@@ -131,9 +131,9 @@ xychart-beta horizontal
 
 As anyone would expect, [Git](https://git-scm.com/) is the most used solution by 91% of our participants. 
 
-However, we see that 6% are not using any version-control-system in their projects. In large companies, we see that some system administrators, security professionals, Telco and database engineers don't using VCS at their work.
+However, we see that 6% are not using any version-control-system in their projects. In large companies, we see that some system administrators, security professionals, Telco and database engineers don't use VCS at their work.
 
-This point that engineers in these companies do their work "manually", which puts the assumption that those companies don't use IaC, CaC or GaC to provision and manage infrastructures.
+This point that engineers in these companies do their work "manually", which signals that those companies don't use IaC, CaC or GaC to provision and manage infrastructures.
 
 Some ERP/CRM are bought and/or developed from external providers, then companies may only user their internal engineers to "manage" or just use them, therefor they may not develop that much.
 

website/docs/insights/data-and-ml.md

@@ -12,7 +12,7 @@ Private sector, and startups are mining data and making use of it to better leve
 
 On a global level, data science and machine learning are trending, especially with the widespread of LLMs and different generative AI models that got more "human" and closer to average non-technical consumers with different ChatBot applications. This trend may get people's interest into adopting this field as a profession, or hire professionals in this domain.
 
-In this section of our report, we will answer serval questions:
+In this section of our report, we will answer several questions:
 
 ## Are there any data-protection laws in Algeria?
 
@@ -55,7 +55,7 @@ However, many other agencies are lacking behind, or still showing outdated data
 
 Public data can be obtained by crawling different sources, or by consuming ready-to-use datasets which are available from different sources.
 
-### Applications adn websites
+### Applications and websites
 
 As the collection and the management of personal data is regulated under tha law [ANPDP](https://anpdp.dz/fr/quand-et-a-qui-sapplique-la-loi-n18-07/), websites and applications can collect data to improve their users' experience and to better understand their client base.
 

website/docs/insights/technology-trends.md

@@ -26,23 +26,24 @@ Click here to see the full chart
 
 ## Programming languages
 
+Our main finding in regards to programming language is that JavaScript is the most used programming language, followed by Python and PHP as shown below.
+
+<br/>
+
 ```mermaid
 xychart-beta horizontal
   x-axis ["JavaScript","HTML/CSS","Python","TypeScript","PHP", "Java","Dart","C#","C++","C","Go","Kotlin","Matlab","Rust", "Delphi"]
   bar [362,344,217,214,143,122,78,61,48,45,37,34,22,21,15]
 ```
 
-*You can see the [all submitted programming languages in our appendix section](/docs/appendix/raw-results#which-languages-do-you-frequently-use-in-your-work).*
+*You can explore [all submitted programming languages in our appendix section](/docs/appendix/raw-results#which-languages-do-you-frequently-use-in-your-work).*
 
 <br/>
 
-JavaScript is the most used programming language, followed by Python and PHP according to our survey data.
-
-According to [Google trends](https://trends.google.com/trends/explore?date=2018-01-03%202024-03-22&geo=DZ&q=%2Fm%2F060kv,%2Fm%2F07sbkfb,%2Fm%2F02p97,%2Fm%2F05z1_,Flutter), we notice that the interest in Java is declining with an increase of interest in Python, JavaScript and Dart/Flutter.
+To further understand the trend, we look to [Google trends](https://trends.google.com/trends/explore?date=2018-01-03%202024-03-22&geo=DZ&q=%2Fm%2F060kv,%2Fm%2F07sbkfb,%2Fm%2F02p97,%2Fm%2F05z1_,Flutter) and notice that the interest in Java is declining with an increase of interest in Python, JavaScript and Dart/Flutter.
 
 ![Programming language trends](/img/stats/external/google-trends-programming-langs.png)
 
-We have some observations from this graph and our survey data.
 
 ### JavaScript is everywhere
 
@@ -61,6 +62,7 @@ For mobile applications, [we also saw that JavaScript is competing with Flutter,
 
 ```mermaid
 xychart-beta horizontal
+  title "Technologies used for mobile development"
   x-axis ["React Native", "PWA", "Ionic", "Nativescript"]
   bar [118, 71, 6, 1]
 ```
@@ -71,14 +73,15 @@ In our question about [what technologies our participants use to build desktop a
 
 ```mermaid
 pie
+    title "Technologies used for desktop applications"
     "Electron" : 98
     "JavaFX" : 51
     "Java Swing" : 45
     ".NET Core" : 42
     "WPF (Windows Presentation Foundation)" : 28
 ```
 
-However, even with the hyper growth of JavaScript community, hiring managers are struggling to find "good seniors", or at least "good JavaScript" developers.
+This section tells us that the growth of Javascript is currently affecting Algeria as well in mobile development, desktop development and web development. However, even with this growth of the JavaScript community, hiring managers are struggling to find "good seniors", or at least "good JavaScript" developers.
 
 ### Increasing interest in Python
 
@@ -103,6 +106,7 @@ Our participants use Tkinter, Kivy, PyQT and PySide2 to build desktop applicatio
 
 ```mermaid
 pie
+    title "TITLE TBD"
     "Tkinter (Python)" : 27
     "Kivy (Python)" : 8
     "PyQT": 3
@@ -117,6 +121,7 @@ Flutter is the most used technology to build mobile applications [according to o
 
 ```mermaid
 pie 
+    title "Most used technologies for building mobile applications"
     "Flutter" : 132
     "React Native" : 118
     "HTML/CSS and JavaScript for PWA" : 71
@@ -159,6 +164,7 @@ According to our survey participants who live in Algeria, and work for Algerian
 
 ```mermaid
 pie showData
+    title "Top Databases used in Algerian companies"
     "MySQL" : 13
     "PostgreSQL" : 11
     "Microsoft SQL Server" : 7
@@ -171,7 +177,7 @@ pie showData
     "Elasticsearch" : 2
 ```
 
-Large companies in Algeria such as Sonatrach and Djezzy, use proprietary database management systems like Oracle and Microsoft SQL Server. While startups like [Yassir](https://yassir.com/) and [Maystro Delivery](https://maystro-delivery.com/) mainly use MongoDB, Redis and PostgreSQL.
+According to their job offers and public communication, large companies in Algeria such as Sonatrach and Djezzy, use proprietary database management systems like Oracle and Microsoft SQL Server. While startups like [Yassir](https://yassir.com/) and [Maystro Delivery](https://maystro-delivery.com/) mainly use MongoDB, Redis and PostgreSQL.
 
 ## Mobile development