Skip to content

Fcmam5/state-of-dz-swe-2024

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The state of Algerian Software engineering 2024

Welcome to the official repository for The state of Algerian Software engineering 2024 (state-of-algeria.dev) report and website.

This project is dedicated to providing a comprehensive overview of the software engineering landscape in Algeria as of 2024. The report aims to capture key trends, challenges, and opportunities in the Algerian software engineering sector, serving as a valuable resource for developers, companies, educators, and policymakers.

We based this study on a survey we ran from February to March 2024, where we collected inputs from 517 participants. Then we conducted several interviews with experts and different actors in IT fields.

The report is published as a website (state-of-algeria.dev), and we are working on providing a PDF summary for it.

Tip

The website is also available as a progressive web app (PWA) and it can be browsed offline Screenshot of the trends page

We intentionally used MermaidJS for plots and graphs to make content translatable and searchable by website users, and to make it easier for us in code-reviews, also, it's fun to work with!

About this repository

This repository contains the website's content under website directory.

The website is build with Docusaurus, a framework that just makes sense.

We used it for different reasons:

  1. Easy setup, with a comprehensive documentation.
  2. Allows to both use Markdown and React. Markdown made it easier convenient to just focus on writing the content and not caring much about the website's structure. And React made things flexible enough when needed.
  3. It had enough tools and integrations to get the job done (e.g. Algolia and Mermaid libraries).
  4. Developers, who are our main target audience, are (or should be) used to navigate in documentation websites, or some OSS books online, and we wanted to provide the same UX to them.

In the second folder (data-processing) I shamelessly pushed some dirty and hacky scripts I used to perform some operations, transformations and formatting to markdown or Mermaid graphs.

Some data science was done by my brother Oussama Fortas, and he pushed its code on a private repository.

Support

If you want to support this initiative, head to our support page: https://state-of-algeria.dev/support (since you're on Github: website/src/pages/support.md)

You can donate through the platforms we linked to in that page, or on this repository's sponsor button.

Contributing

We would like to freeze the content for this first edition, we appreciate your feedback and we are collecting it from different sources (social media, our feedback page, etc).

If you want to improve our website's usability, SEO, etc. Please create a Github issue.

And if you want to extend our content, please contact us first and we see how to incorporate your contribution. It would most likely be published in an appendix or as a page in our blog (https://state-of-algeria.dev/blog).

Help us spread the word about this project, and start conversations around it

Please use #dzDevSurvey24 and/or tag me (Abdeldjalil Fortas, or "Fcmam5") when you start a discussion about one of the topic we brought in this report.

If you are a content creator, and you mentioned our work, please link to it here in mentions-and-discussions.md file, it will appear in: https://state-of-algeria.dev/mentions-and-discussions

License

This project is licensed under the MIT License.

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •