Forem: Kali Academy

Mon parcours de stage à KADEA Academy Goma

Idrissa HEMEDY — Wed, 19 Feb 2025 05:26:50 +0000

Introduction

Le processus d'apprentissage dans le système LMD au Congo Kinshasa demande aux étudiants universitaires de compléter leur cursus de licence par un stage académique avant de passer au cycle suivant.
C'est la raison première de mon stage à KADEA Academy.

Plus encore, étant du domaine Informatique, un stage en milieu professionnel est une opportunité excellente pour mettre en pratique les connaissances acquises à la faculté, les évaluer et acquérir d'autres connaissances. Celle-ci est la deuxième raison de mon stage sans pour autant être moindre.

Parcours

I. Période de stage

Mon stage est allé du 12 Aout au 21 Septembre 2024, une période de 6 semaines en travaillant du lundi au vendredi chaque semaine

II. Organisation du travail

Chaque semaine, j'avais un ensemble de tâches à réaliser pour atteindre les objectif de mon stage.
Le travail est censé commencer chaque jour à partir de 8h30 et prendre fin aux alentours de 16h30.
Pour chaque jour, un Daily Standup doit être établi. Celui-ci reprend les tâches accomplies le jour précèdent, celles à réaliser le jour dont il est question et les éventuels blocages auxquels on a été confronté.

II.1. Objectifs du stage

Pour mon stage, j'ai pour objectif:

Réaliser une version simple d'une application permettant à une organisation de tracker les visites faites dans ses locaux
Faire 2 pull requests sur des projets open source
Animer quelques sessions d'info gratuites offertes sur HTML et CSS
Publier 3 articles, les 2 premiers portant sur des sujets de notre choix et le dernier portant sur mon parcours chez KADEA

II.2. Outils de travail

Voici les outils qu'on a eu à utiliser:

Slack: pour la communication
Git & GitHub: pour la le versioning du code
VS Code: pour l'implémentation du code et le développement
Trello: pour le planning des activités de développement
Figma: pour le design de la plateforme

III. Présentation du projet de stage

Le projet sur lequel nous avons eu a travailler le temps de notre stage est VisiTrack.

Visitrack est une application web qui permet aux entreprises de retracer l’historique des visites qui ont été faites dans leurs locaux. Les utilisateurs, une fois connectés, enregistrent quotidiennement toutes les visites en enregistrant le nom et postnom du visiteur, la raison de sa visite, l’heure d'arrivée et celle de départ.

III.1. Liens

Live: https://visitrack.vercel.app
GitHub: https://https://github.com/e-idrissa/visitrack-app
Figma: https://www.figma.com/design/QyPYvqPlk36AkPClnSn0tV/Visitrack?node-id=0-1&node-type=canvas&t=jqfozwbfVIfoRyKO-0

III.2. Fonctionnement

Pour utiliser VisiTrack, l'utilisateur se rend sur la page web et s'inscrit s'il n'a pas encore de compte ou alors s'authentifie s'il est déjà inscrit.
Une fois connecté, l'utilisateur pourra à on aise créer des visites, les modifier ou les supprimer.

III.3. Améliorations

Ce projet n'étant qu'une première version d'une application possiblement commercialisable, voici les améliorations qu'il est possible de lui apporter:

Ajouter un compte administrateur pour ne pas permettre a tout le monde d'accéder a la plateforme.
Implémenter une application mobile pour une meilleur portabilité

IV. Contributions open source

Les contributions open source que nous avons accomplies, étant aussi les toutes premières que nous ayons eu à faire sont les suivantes :

V. Articles

Mise à part celui-ci, nous avons aussi publié nos deux premiers articles sur dev.to pendant le stage: un article sur la contribution open source et un article sur la gestion des projets en software engineering

Appréciations

Le stage s'est en soit très bien déroulé et dans un environnement convivial, calme et favorisant l'apprentissage.

Les coachs nous ont offert une bonne expérience et un bel aperçu du travail auquel on s'attend en tant qu'informaticien ; la convivialité, la rigueur, la discipline et la flexibilité dans le travail.

HTML ( HyperText Markup Language )

Stephanie Chekwubechukwu — Wed, 27 Nov 2024 12:53:49 +0000

WHAT IS HTML ?
HTML stands for HyperText Markup Language. HTML is the standard markup language for creating Web pages. It allows the creation and structure of sections, paragraphs, and links using HTML elements (the building blocks of a web page) such as tags and attributes.

HISTORY OF HTML
The first version of HTML was written by Tim-Berners-Lee in 1993. Since then, there have been many different versions of HTML. The most widely used version throughout the 2000's was HTML 4.01, which became an official standard in December 1999. Another version, XHTML, was a rewrite of HTML as an XML language.

HTML has a lot of use cases, namely:
Web development. Developers use HTML code to design how a browser displays web page elements, such as text, hyperlinks, and media files.
Internet navigation. Users can easily navigate and insert links between related pages and websites as HTML is heavily used to embed hyperlinks.
Web documentation. HTML makes it possible to organize and format documents, similarly to Microsoft Word.
STRUCTURE OF HTML

<!DOCTYPE> <html> , <head> , <title> and <body> .

COMMON TAGS IN HTML

<p>: Used for paragraphs of text.
<h1> to <h6>: Used for headings of different sizes.
<a>: Used for hyperlinks.
<img>: Used for displaying images.
<ul> and <ol>: Used for creating unordered and ordered lists.
<div>: Used for grouping and styling elements.
<input>: Used for creating input fields.

The basic elements of an HTML page are:

A text header, denoted using the <h1>, <h2>, <h3>, <h4>, <h5>, <h6> tags.
A paragraph, denoted using the <p> tag.
A horizontal ruler, denoted using the <hr> tag.
A link, denoted using the <a> (anchor) tag.
A list, denoted using the <ul> (unordered list), <ol> (ordered list) and <li> (list element) tags.
An image, denoted using the <img> tag
A divider, denoted using the <div> tag
A text span, denoted using the <span> tag
The next few pages will give an overview of these basic HTML elements.
Each element can also have attributes - each element has a different set of attributes relevant to the element. There are a few global elements, the most common of them are:
id - Denotes the unique ID of an element in a page. Used for locating elements by using links, JavaScript, and more.
class - Denotes the CSS class of an element. Explained in the CSS Basics tutorial.
style - Denotes the CSS styles to apply to an element. Explained in the CSS Basics tutorial.
data-x attributes - A general prefix for attributes that store raw information for programmatic purposes. Explained in detailed in the Data Attributes section.
Text headers and paragraphs
There are six different types of text header you can choose from, h1 being the topmost heading with the largest text, and h6 being the most inner heading with the smallest text. In general, you should have only one h1 tag with a page, since it should be the primary description of the HTML page.
As we've seen in the last example, a paragraph is a block of text separated from the rest of the text around it.

Let's see an example of the <h1>, <h2> and <p> tags in action:

<!DOCTYPE html>
<html>
    <head>
    </head>
    <body>
        <h1>My First Page</h1>
        <p>This is my first page.</p>
        <h2>A secondary header.</h2>
        <p>Some more text.</p>
    </body>
</html>

Horizontal rulers

A horizontal ruler <hr> tag acts as a simple separator between page sections.
<!DOCTYPE html>
<html>
    <head>
    </head>
    <body>
        <h1>My First Page</h1>
        <p>This is my first page.</p>
        <hr>
        <p>This is the footer - all rights are reserved to me.</p>
    </body>
</html>

CONCLUSION
HTML remains the foundation of web development, providing the structure, semantics, and functionality necessary for creating modern websites. Its integration with CSS allows for attractive and responsive designs, while its support for multimedia and interactive content enhances user engagement. Moreover, HTML's emphasis on accessibility and SEO ensures that web pages are inclusive and easily discoverable. As web technologies continue to evolve, HTML continues to be a vital tool for developers, enabling them to build dynamic and accessible web experiences for users across the globe.

CSS: Crafting the Visual Brilliance of the Web

Onyedika Eze — Wed, 27 Nov 2024 09:10:39 +0000

In the world of web development, HTML and JavaScript often steal the spotlight, but it's CSS (Cascading Style Sheets) that brings the visual magic to web pages. CSS is the language that allows you to style, layout, and design your web pages, ensuring that the user experience is both aesthetically pleasing and functional. Let's dive into the essentials of CSS and understand why it is an indispensable tool for web developers.
What is CSS?
CSS is a stylesheet language used for describing the presentation of a document written in HTML or XML. It separates the content of the web page (HTML) from its presentation (CSS), enabling developers to apply consistent styling across multiple pages with ease. By defining how elements should be displayed on the screen, CSS transforms plain HTML into a visually engaging experience.

Core Concepts of CSS
Selectors and Properties CSS uses selectors to target HTML elements and apply styles to them. Properties define the specific styles to be applied.
For example:
CSS

p {
    color: blue;
    font-size: 16px;
}

This rule targets all

elements, setting their text color to blue and font size to 16 pixels.
The Cascade The 'Cascading' part of CSS refers to the way styles cascade from the top of the document to the bottom, with the most specific rules taking precedence. This allows developers to layer styles and create complex designs with minimal code.
Box Model Every element in CSS is considered a box. The box model describes the space an element occupies on a page, including content, padding, border, and margin. Understanding the box model is crucial for creating layouts.
plaintext

+-------------------+
| Margin |
| +------------+ |
| | Border | |
| |+---------+ | |
| || Padding | | |
| || Content | | |
| |+---------+ | |
| +------------+ |
+-------------------+

Layouts and Positioning CSS provides various techniques for laying out elements, such as flexbox, grid, and positioning. Flexbox and grid are modern layout models that offer more control and flexibility compared to traditional methods like float and table-based layouts.

CSS

.container {
display: flex;
justify-content: space-between;
}

Why CSS is Critical for Web Design

Separation of Concerns By keeping HTML focused on structure and CSS on presentation, developers can maintain cleaner, more manageable code. This separation simplifies updates and ensures a consistent look and feel across an entire website.
Responsive Design CSS is essential for creating responsive designs that work well on various devices and screen sizes. Media queries allow developers to apply different styles based on the viewport, ensuring an optimal user experience on desktops, tablets, and smartphones.

CSS

@media (max-width: 768px) {
.container {
flex-direction: column;
}
}

Performance and Accessibility Well-written CSS can enhance website performance by reducing the amount of code processed by the browser. Additionally, CSS aids in accessibility by enabling high-contrast modes, large text, and other styles that improve usability for individuals with disabilities.

Conclusion

CSS is more than just a tool for beautifying web pages; it's a powerful language that enhances the structure, functionality, and user experience of web applications. As the web continues to evolve, mastering CSS remains a crucial skill for any web developer aiming to create visually stunning and highly functional websites. Whether you're styling a single page or an entire web application, CSS is your best ally in crafting the visual brilliance of the web.

Project Management in Software Engineering

Idrissa HEMEDY — Mon, 09 Sep 2024 07:59:17 +0000

Introduction

As developers, we often chase after the next groundbreaking idea or seek opportunities to maximize our earnings through coding 🤑. However, before those dreams become reality, we frequently find ourselves working on team or personal projects. Many of us might not fully realize how crucial it is to properly structure and present these projects.

A well-organized project structure and clear presentation are essential. They not only provide a comprehensive view of what we’re building but also contribute to maintaining clean and efficient code 🧑‍💻.

Achieving a solid project structure and effective presentation is possible with a robust project plan and diligent project management. By focusing on these aspects, we set ourselves up for success, both in realizing our current projects and in reaching our broader career goals.

In this article, we’ll explore the fundamentals of project management in software engineering.

Project management and Project plan

We previously talked about project management and project plan if we want to achieve a solid project structure. What is the difference between them?

What is a project management?

Project management involves leading and directing a project from start to finish. It includes applying knowledge, skills, tools, and techniques to ensure that the project meets its requirements and achieves its goals.

What is project plan?

A project plan is a comprehensive document that outlines the scope, objectives, tasks, timeline, resources, and budget of a project. It serves as a roadmap for the project team, ensuring everyone is aligned and working towards a common goal.

In summary, the project plan is a comprehensive document that outlines the details of a project, while project management is the overall process of planning, executing, and controlling the project to achieve its goals. Both are essential for successful project outcomes.

Project management in Software engineering

Project management in software engineering is a systematic approach to planning, organizing, and controlling the development of software projects. It ensures that projects are completed on time, within budget, and meet the specified quality standards.

Key considerations in software project management include:

Timeliness: Projects must be completed within agreed-upon deadlines to meet customer expectations and avoid delays.
Budget: Projects are allocated a fixed amount of resources, including human, financial, and material resources. Adhering to the budget is crucial to avoid cost overruns.
Quality: Software must meet specific functional and non-functional requirements to deliver value to users. Ensuring quality throughout the development process is essential.

Ignoring any of these three factors can lead to project failures or suboptimal outcomes.

Approach

In software engineering, there are 2 main approaches when it comes to project management:

Agile: This iterative approach emphasizes flexibility, collaboration, and continuous improvement. It involves breaking down the project into smaller increments (sprints) and delivering working software at the end of each sprint.
Waterfall: This traditional approach follows a linear sequence of phases

Choosing the right project management approach depends on the project's characteristics. If the project involves frequent changes, uncertain requirements, or a need for continuous feedback, an Agile approach is often suitable. Else if the project has well-defined requirements, a stable scope, and a predictable timeline, a Waterfall approach might be more appropriate. Waterfall methodologies follow a sequential process, moving from one phase to the next.
It's important to note that hybrid approaches, combining elements of Agile and Waterfall, can also be effective in certain situations.

Project Planning and Scheduling

there are 3 principal alternatives :

Work Breakdown Structure (WBS): Divides the project into smaller, manageable tasks.
Gantt Charts: Visualize the project schedule, showing task dependencies and deadlines.
Critical Path Method (CPM): Identifies the longest path through the project network and highlights critical tasks that must be completed on time to avoid delays.

Risk management

This process involves three key steps:

Risk Identification: Identifying potential threats or challenges that could negatively impact the project's success.
Risk Assessment: Evaluating the likelihood and severity of each identified risk.
Risk Mitigation: Developing strategies to reduce or eliminate the identified risks, or to create contingency plans to address them if they occur.

Quality Assurance and Testing

Quality assurance (QA) and testing are crucial for ensuring software works as expected. Here's a breakdown:

Unit Testing: Check individual parts of the software.
Integration Testing: See how different parts work together.
System Testing: Test the whole software to make sure it works.
Acceptance Testing: Make sure the software meets the customer's needs. By doing these tests, software teams can find and fix problems early, making the software better.

Configuration Management

Version Control: Keep track of changes to the software's code and documentation. This helps you see what has been changed and when, making it easier to collaborate and manage different versions.
Change Management: Manage changes to the project's goals, what it needs to do, or how it's designed. This ensures that everyone is on the same page and that changes are made systematically.

Communication and Collaboration

Stakeholder Management: Make sure everyone understands what's expected and communicates clearly. This includes customers, developers, and managers.
Team Collaboration: Encourage teamwork and open communication within the development team. This helps everyone work together effectively and solve problems.

Project Monitoring and Control

Progress Tracking: Check how the project is going compared to the plan and budget.
Issue Tracking: Look for any issues that might slow down the project and fix them.
Performance Evaluation: See how the team is working and make changes if needed.

Tools and Technologies

Project Management Software: Use tools like Jira, Trello, or Asana to manage tasks, track progress, and work together.
Version Control Systems: Use Git, SVN, or Mercurial to keep track of changes to the software's code.
Issue Tracking Tools: Use Bugzilla or GitHub Issues to find and fix problems.

Main Activities

Software project management involves a wide range of activities, such as:

Initiation: Define what the project is about, its goals, and if it's possible to do.
Planning: Create a detailed plan for the project, including all the important parts.
Executing: Follow the plan and do the work needed for the project.
Monitoring and Controlling: Watch how the project is going, find any problems, and fix them.
Closing: Complete the project, deliver the final product, and see how well it went.

Conclusion

Effective project management is the key to successful software development. By implementing a comprehensive project plan and utilizing the right tools and strategies, you can streamline your development process, mitigate risks, and deliver high-quality software on time and within budget. The techniques outlined in this article, including project planning, risk management, communication, and quality assurance, provide a solid foundation for achieving project success. Remember, a well-structured project and effective leadership are essential for delivering exceptional results.

Open source Contribution, First Pull Request

Idrissa HEMEDY — Mon, 09 Sep 2024 07:55:07 +0000

Introduction

As newcomers to web development, we often believe that the only way to improve our skills is by working on our own projects. But what happens when you run out of project ideas or don't have a team to collaborate with? Should you close your code editor and put your ambitions on hold? This is where Open Source Contributions can make a significant difference. By contributing to open source, you not only hone your coding skills but also become part of a global community that builds and maintains software used by millions. Whether it's your first pull request or your hundredth, open source offers endless opportunities for learning, collaboration, and growth.

What is an Open source Contribution?

An open source contribution refers to the act of participating in the development or improvement of open source software. Open source software is software that is freely available for anyone to use, modify, and distribute.

Open source contributions are typically made through platforms like GitHub, where developers can submit changes via pull requests that are reviewed and potentially merged into the main project by the maintainers.

What can I contribute on?

Contributions can come in various forms, including:

Code Contributions: Writing new features, fixing bugs, or improving existing code.
Documentation: Creating or improving documentation to help others understand how to use the software, how it works, or how to contribute.
Design: Contributing to the visual design, user interface, or user experience of the project.
Testing: Writing tests, reporting bugs, or helping to ensure the software works as intended across different environments.
Translation: Translating the software and its documentation into different languages to make it accessible to a broader audience.
Community Support: Helping other users and contributors by answering questions, providing guidance, or reviewing pull requests.

Open source project ideas

Here is some beginner friendly open source projects you can look on:

Pull Request

As discussed earlier, pull requests (PRs) are the primary method developers use to submit their changes to open source projects. When a developer opens a PR, it signals to the project maintainers that new code is ready for review. The maintainers carefully evaluate the PR, ensuring that the changes contribute value to the project without introducing any issues or breaking existing functionality. If the PR meets these criteria, it is merged into the main codebase, becoming part of the official project.

Step by Step guide to your First PR

We assume that you are already familiar with Git and GitHub, and have them set up on your machine. If not, refer to this article on how to install Git on Windows and How to set it up.

Once you have everything set up and have chosen the project you want to contribute to, follow these steps to make your first PR

1. Create a copy of the repository

A repository, or "repo," is essentially the main folder where a project is stored on GitHub. To start working on an open-source project, you first need to create your own copy of the repository. This process involves forking the repository to create a copy under your GitHub account and then cloning it to your local machine, giving you a working version of the project that you can modify and experiment with.

a. Forking
When you’re on the main page for the repository, a Fork button will be displayed on your upper right-hand side of the page, underneath your user icon:

Follow the process and end with the forking.

b. Cloning
You can copy the URL by using the green “⤓ Code” button from your repository page that you forked from the original repository page. Once you click the button, you’ll be able to copy the URL by clicking the clipboard button next to the URL. Open your terminal. navigate to the folder you want to clone the project to and clone it using this Git command:

git clone --copied-link

After that, navigate to the cloned folder by taping:

cd cloned-project

2. Create new branch and start modifications

Before you begin working on the code and making changes, it's important to create a new branch. This branch will serve as a separate workspace for your code modifications, keeping them isolated from the main codebase. Your changes will be saved and reviewed on this branch before they are potentially merged into the project. To create a new branch and switch to it, open your terminal and enter the following command:

git checkout -b --your-branch-name

🎉 You're done. You can now make changes and save them.

3. Save local changes and commit

After working on your changes, you'll need to save them locally by doing:

git add -A

And then commit your changes:

git commit -m "Custom commit message"

4. Update local repository

When working on a project with other contributors, it’s crucial to keep your local repository up-to-date to avoid conflicts when making a pull request. To do this, you need to sync changes regularly.

First, we'll cover how to configure a remote for your fork, then how to sync it with the original repository

a. Configure a remote
Let’s first check which remote servers you have configured. From the directory of the repository in our terminal window, let’s use the git remote command along with the -v flag to display the URLs that Git has stored along with the relevant remote

git remote -v

Next, we’ll specify a new remote upstream repository for us to sync with the fork. This will be the original repository that we forked from. We’ll do this with the git remote add command

git remote add upstream --original-repo-link

We can verify that our remote pointer to the upstream repository was properly added by using the git remote -v command again from the repository directory.

b. Sync the fork
To sync our fork, from the directory of our local repository in a terminal window, we’ll use the git fetch command. Since we used the shortname “upstream” to refer to the upstream repository, we’ll pass that to the command:

git fetch upstream

Now, commits to the main branch will be stored in a local branch called upstream/main.

Let’s switch to the local main branch of our repository:

git checkout main

And merge our changes:

git merge upstream/main

Your fork’s main branch is now in sync with the upstream repository, and any local changes you made were not lost.

5. Create a PR

At this point, you are ready to make a pull request to the original repository.

You should navigate to your forked repository, and press the New pull request button on your left-hand side of the page.

Follow the steps and there we go, your first Open source Contribution is live and you achieve your first PR.
🎉🎉 Congratulations.

Conclusion

Contributing to open source through your first pull request is a rewarding experience that accelerates your growth as a developer. It’s not just about improving your coding skills, but also about collaborating with a global community, learning best practices, and making a meaningful impact. By following these steps, you’re not just submitting code—you’re joining a movement that powers countless projects around the world. Dive in, contribute, and watch your skills and confidence soar.

Understanding TypeScript: A Friendly Guide

Birusha Ndegeya — Thu, 08 Aug 2024 10:03:07 +0000

Understanding TypeScript: A Friendly Guide

Hi there! I’m Birusha Ndegeya, a software developer passionate about building robust and maintainable applications. Today, I want to share some insights into TypeScript, a powerful tool that can transform the way you write JavaScript.

What is TypeScript?

TypeScript is a superset of JavaScript that adds optional static typing. This means you can add type annotations to your code, which helps you catch errors early and makes your code more readable and maintainable.

How Does TypeScript Work?

Compilation: TypeScript code isn’t directly executed by browsers. Instead, it’s compiled into plain JavaScript using a compiler like tsc. This compiler checks for type errors and generates JavaScript code that browsers can run.
Type System: The core of TypeScript is its type system. Types help define what kind of data a variable can hold. Some common types include:
- number: Represents numbers.
- string: Represents text.
- boolean: Represents true or false values.
- array: Represents a list of values of a specific type.
- object: Represents a collection of key-value pairs.
Type Inference: TypeScript is smart enough to infer types in many cases, so you don’t always need to explicitly specify them.
Interfaces & Classes: TypeScript provides interfaces to define the structure of an object and classes to create reusable components.
Generics: TypeScript allows you to create reusable components that can work with different types, making your code more flexible and efficient.

When to Use TypeScript

While TypeScript is a powerful tool, it’s not always the right choice. Here’s when you should consider using it:

Large Projects: TypeScript is ideal for large and complex projects where maintainability and code quality are crucial. The type system helps prevent bugs and makes the code easier to understand and modify.
Teams: When working in a team, TypeScript improves collaboration by enforcing consistent coding styles and ensuring everyone understands the codebase.
Code Reusability: TypeScript encourages code reuse through interfaces and generics, making it easier to build modular and maintainable applications.
Improved IDE Support: TypeScript integrates well with IDEs, providing features like autocompletion, type checking, and code navigation.

Alternatives to TypeScript

While TypeScript is popular, other alternatives exist:

Flow: A static type checker for JavaScript that aims to provide similar benefits to TypeScript.
ReasonML: A functional language that compiles to JavaScript and provides strong typing and other features like immutability.
PureScript: A functional language that compiles to JavaScript and focuses on immutability and strong types.

The Importance of TypeScript

Using TypeScript offers significant advantages:

Improved Code Quality: Type checking helps catch errors before runtime, reducing bugs and improving code reliability.
Increased Maintainability: TypeScript’s strong typing makes code easier to understand and maintain, especially in large projects.
Better Developer Experience: IDEs provide enhanced features like autocompletion and type checking, leading to faster development cycles.
Enhanced Collaboration: TypeScript enforces consistent coding styles and makes it easier for teams to work together.

When Not to Use TypeScript

Small, Simple Projects: The overhead of writing type annotations may not be worth it for small, simple scripts.
Projects with Tight Deadlines: The additional compilation step can slightly increase development time.
Projects with Limited Resources: TypeScript requires a steeper learning curve and may require additional tooling.

Conclusion

TypeScript is a powerful tool for building robust, maintainable, and scalable applications. However, it’s important to carefully consider the pros and cons before adopting it for your project. If you’re working on a large or complex application, or if you value code quality and maintainability, TypeScript can be a valuable asset. Ultimately, the decision to use TypeScript depends on the specific needs and constraints of your project. Carefully evaluate the pros and cons to make the best choice for your development environment.

I hope this guide helps you understand the basics of TypeScript and its benefits. Happy coding!

Feel free to reach out if you have any questions or need further clarification. I'm always here to help fellow developers on their coding journey!

SUR LE CHEMIN DU HACKING ! Kali Academy, trois mois d’initiation 👺

Tacite WAKILONGO — Fri, 14 Jun 2024 22:20:06 +0000

Et oui 🙂 vous ne rêvez pas ! Je dis dis bien hacking ! Avant tout, mettons-nous d'accord sur la terminologie “Hacking”. Les médias nous ont menti sur le hacking, ils confondent le hacking au cracking. Richard Stallman, un fervent défenseur du logiciel libre et fondateur du mouvement du logiciel libre, définit un hacker comme quelqu'un qui aime jouer avec des systèmes, comprendre leur fonctionnement interne et les améliorer. Le hacking, dans ce contexte, est un acte de créativité, d'innovation et de résolution de problèmes, souvent associé à la programmation informatique. C’est une part de vérité, le hacking est bien plus que cette définition, il est en soi un état d’esprit, une manière de penser… Je vous conseille de lire cet ouvrage pour en savoir plus sur cette littérature : “Hackers and Painters: Big Ideas from the Computer Age” de Paul Graham.

Introduction

Dans cet article, je vais vous parler du parcours que propose Kali Academy aux jeunes développeurs pour les initier au Hacking. Kali Academy est une académie qui vise à promouvoir les valeurs de l'open source dans les régions les moins représentées notamment en Afrique, voir le site de Kali Academy. J’ai personnellement été parmi les 10 stagiaires retenus pour la cohorte 2024 et c’est fut une énorme opportunité pour ma carrière de développeur, je me sens dans l’obligation de partager avec cette expérience assez passionnante. Avant d’entrer dans le vif du sujet, je tiens a préciser que je ne me considère pas hacker, et je ne me considérerai jamais hacker, c’est la pertinence de mon travail qui pourra me procurer ce titre.

Le parcours de stage chez Kali Academy est subdivisé en 3 parties :

les fondamentaux
la spécialisation Wikimédia et
le projet de fin de stage.

Mais avant de décortiquer ce programme apparemment, commençons par nous poser les bonnes questions en guise de fondamentaux 🙂. Qui construit et entretient l'infrastructure numérique sur laquelle nous nous appuyons au quotidien ? Quels sont les défis et les obstacles rencontrés par ceux qui travaillent à la construction et à la maintenance de cette infrastructure ? Quelles sont les implications sociales, politiques et économiques de la manière dont l'infrastructure numérique est construite et gérée ? Comment les décisions prises en matière d'infrastructure numérique affectent-elles la vie quotidienne des gens ? Quels sont les modèles de financement et de gouvernance de l'infrastructure numérique, et comment peuvent-ils être améliorés ? Comment pouvons-nous garantir que l'infrastructure numérique reste ouverte, accessible et équitable pour tous ? Ces questions semblent peut-être basiques, mais elles poussent à une très grande réflexion si on y consacre un peu d'attention.

Sur quoi est basé notre infrastructure numérique ?

Selon Nadia Eghba, dans son livre (essaie) "Roads and Bridges: The Unseen Labor Behind Our Digital Infrastructure", il nous rappelle que toute notre infrastructure numérique est basée sur l’open source. Personnellement, lorsque j’ai lu ce passage, la première question je me suis demandé qui est derrière les projets open source, comment gagne-t-il sa vie…. C’est à ce moment que j'ai compris l’importance d’une contribution, même aussi petite soit-elle. Nous posons des questions sur des forums tels que stack overflow, mais est-ce qu’on se demande qui nous répond, ni même pourquoi il nous répond ? Nous lisons des articles sur ce site, et nous savons que leurs auteurs ne perçoivent rien comme droit d’auteur mais nous écrivent quand-même. C’est avec ces genres des questions qu’on devient hacker. Etes-vous toujours prêt à le devenir ? Si oui, demandes-toi quelle est ta part dans tout ça, combien de fois as-tu contribué dans un projet open source ou même partager publiquement et gratuitement tes connaissances ? L’open source ce n’est pas seulement dans l’informatique, la liberté d'être bien informé ne peut être garantie que si l’information est open source (souvenez-vous de l’affaire Wikileaks ayant conduit à l’arrestation de Julian Assange et Chelsea Manning), la connaissance ne peut-être universelle que si elle a été partagée (les brevets publiques) ! Voyons notre part dans tout ça, bien que minime soit-elle mais elle est là. C’est de cette manière que Kali Academy m’a amené à voir les choses, consacrer un peu de mon temps à faire découvrir aux autres ce que nous avons appris dans le but de faire évoluer la connaissance et de la démocratiser 🗽.

GNU/Linux, l'OS des Hackers

Maintenant que nous avons découvert que toute notre infrastructure numérique est grandement basée sur de l’open source, rentrons dans le technique. GNU/Linux, savez-vous de quel animal s’agit-il ? 😂 On a souvent tendance à ne dire que Linux et laisser GNU, pourtant Linux n’est que le noyau. GNU est un projet de logiciel libre lancé par Richard Stallman en 1983. Le nom "GNU" est un acronyme récursif qui signifie "GNU's Not Unix", ce qui souligne que bien que GNU soit compatible avec Unix, il n'est pas dérivé de celui-ci. Le projet GNU a pour objectif de fournir un système d'exploitation libre, complet et cohérent composé entièrement de logiciels libres. GNU/Linux est le résultat de l'effort combiné de deux projets : le projet GNU, qui a fourni les outils et les utilitaires, et le noyau Linux, développé par Linus Torvalds. Cette collaboration a produit un système d'exploitation puissant, flexible et libre, qui a eu un impact significatif sur l'industrie informatique et la culture technologique mondiale. Dans mon parcours à Kali Academy, j’ai découvert qu’il est important pour un hackeur d’avoir une idée sur l'architecture d’un système d’exploitation, surtout GNU/Linux car il est open source, on peut se challenger à toucher dans son code et produire notre propre distribution, ce qui est du hacking au sens pur 🙂, ensuite il faut savoir l’installer sans assistance, manipuler bien la ligne de commande, construire des petits scripts bash, automatiser certaines tâches, manipuler l’environnement bureau…

Git, la collaboration facilitée

Ensuite, il faut savoir très bien manipuler git, car c’est la base de la collaboration dans une équipe de développeurs, j’ai récemment commencé à publier une série d’article à sujet je vous invite à aller y jeter un coup d'œil. La plupart des plateformes collaboratives sont basées sur git. Git a pas mal évolué mais il reste intuitif de l’utiliser en CLI.

les licences opens sources, le droit en ingénierie

Lorsque vous installez un logiciel open ou non, vous devez d'abord avoir accepter les termes de la licence. C’est un cas que vous avez déjà rencontré au moins une fois, mais si on n’est pas suffisamment informé, on néglige cette partie, ce qui nous amène à violer les licences. Pour moi, la plus grande victime c’est Microsoft, en tout cas dans le contexte de ma région, sur 1000 personnes que je connais, 900 utilisent Windows, et seulement 100 ont une licence, 50 l’ont payé et les autres ont des craques 😂. C'est triste, mais c’est ça la réalité, pourtant il y a un GNU/Linux gratuit et open source, le seul motif qu’on c’est que Linux est complexe, c’est qui une pure invention de ses concurrents. Cette situation a conduit Kali Academy à nous initier à la lecture des licences open source. Cette lecture nous a mis dans un grande confusion: un logiciel peut être open source mais pas libre, gratuit mais pas libre, libre mais avec une version payante, gratuit mais pas open source 😴. C’est embêtant non ! Mais ce qu’il faut retenir, c’est qu’une licence d'un logiciel est un contrat entre l'éditeur du logiciel et l'utilisateur qui définit les conditions d'utilisation du logiciel. Cette licence précise notamment si l'utilisateur est autorisé à installer le logiciel sur un ou plusieurs appareils, s'il peut le partager avec d'autres personnes, s'il peut le modifier, etc. En échange du respect de ces conditions, l'utilisateur est autorisé à utiliser le logiciel de manière légale.

Voyons maintenant la différence entre un logiciel Open source et un logiciel libre.
Les critères d'un logiciel libre, selon la Free Software Foundation (FSF, initiée par Richard Stallman) , sont les quatre libertés :

Liberté d'exécution : Exemple de Licence : GNU General Public License (GPL) La GPL permet aux utilisateurs d'exécuter le programme pour n'importe quel usage.
Liberté d'étude : Exemple de Licence : GNU General Public License (GPL) La GPL garantit l'accès au code source, permettant aux utilisateurs d'étudier et de modifier le programme.
Liberté de redistribution : Exemple de Licence : GNU General Public License (GPL) La GPL permet aux utilisateurs de redistribuer des copies du programme, que ce soit en version originale ou modifiée.
Liberté de distribution des versions modifiées : Exemple de Licence : GNU General Public License (GPL) La GPL permet aux utilisateurs de distribuer des copies de leurs versions modifiées, tout en conservant les mêmes libertés pour les autres utilisateurs. Les critères d'un logiciel open source, selon l'Open Source Initiative (OSI), incluent les éléments suivants :
Libre redistribution : Exemple de Licence : MIT License La MIT License permet la distribution du logiciel sans restriction.
Code source : Exemple de Licence : Apache License 2.0 La licence Apache 2.0 exige que le code source soit disponible.
Travaux dérivés : Exemple de Licence : BSD License La BSD License permet la modification et la distribution de travaux dérivés sous les mêmes conditions.
Intégrité du code source de l'auteur : Exemple de Licence : Mozilla Public License 2.0 La MPL 2.0 permet les modifications tout en exigeant que les fichiers modifiés soient redistribués sous la même licence.
Pas de discrimination contre des personnes ou des groupes : Exemple de Licence : MIT License La MIT License ne discrimine personne.
Pas de discrimination contre des domaines d'application : Exemple de Licence : Apache License 2.0 La licence Apache 2.0 ne limite pas l'utilisation du logiciel à certains domaines.
Distribution de la licence : Exemple de Licence : GNU General Public License (GPL) La GPL assure que les droits sont transférés à tous les destinataires du programme.
Licence non spécifique à un produit : Exemple de Licence : BSD License La BSD License n'exige pas que le programme soit partie intégrante d'un produit spécifique.
Licence non restrictive pour d'autres logiciels : Exemple de Licence : Apache License 2.0 La licence Apache 2.0 ne pose pas de restrictions sur les logiciels distribués avec le programme.
Licence technologiquement neutre : Exemple de Licence : MIT License La MIT License ne fait pas référence à une technologie spécifique.

Mais ce qu’il faut retenir c’est que tout logiciel libre est open source mais tout logiciel open source n’est pas libre, il y a aussi des gratuiciels (logiciel gratuit mais pas open source). Je vous recommande de mettre, en commentaire, des exemples d'applications ayant telle ou telle autre licence précitée.

Wikimédia, écosystème open source par excellence

C’est dans cela que nous avons passé la majeure partie du premier mois, on avait autant d’ouvrages à consulter, des documentations à parcourir et des ateliers à suivre et parfois partager quand bien même on n’a pas bien assimilé la leçon, bref c'était très intense. Ces connaissances acquises ne pouvaient nous aider en rien si on n’avait pas une bonne communauté où les expérimenter. Il est bien d’avoir une houe, mais il encore mieux de l’essayer au champ 🙂, c’est pourquoi dans le deuxième moi de mon stage chez Kali Academy, nous nous sommes maintenant intéressés aux projets open source, nous avons d’abord cherché de nous même, je me souviens j’avais forké un repo de “awesome” où j’ai eu trop de mal à contribuer et mon PR n’avait même pas été validé, mais mon coach m’a consolé en disant “le plus important c’est que tu as réussi à cloner le projet, à runer le projet et à résoudre l’issue, peut importe que ton PR soit mergé ou pas”, et c'est une des leçons que je garde à cœur. Ensuite, Kali nous a proposé d’approcher l’écosystème Wikimédia qui est de nos jours un des plus grands projets open sources avec son MediaWiki qui est le moteur qui propulse Wikipédia et son projet frères ainsi que d’autres wiki. C’était comme une forte immersion arrivée soudainement. Nous avions d’abord participé à un événement de code que Wikimédia a choisi de nommer “Wishathon”, au cours duquel il fallait corriger quelques bogues et résoudre certains issues dans les projets ciblés dans l’écosystème, c’était très intenses pour nous étant donné que c’était une première fois de nous retrouver dans ces genres d’événement, encore que c’était un événement mondial, je m'étais retrouvé en train de travailler avec un turc aussi débutant que moi en Anglais 😂, mais c’était wow. Ensuite, pour comprendre un peu comment faire mes premières contributions sur Wikipédia, Wikidata, wiki Common …. j’ai postulé à une bourse de la fondation Moleskine laquelle m’a permis de suivre tout cela en seulement 5 séances intenses. J’ai appris à installer MediaWiki de différentes façons, à créer des thèmes, des extensions …. C’était vraiment chouette cette aventure. Ouf ! 😣J’ai oublié de vous révéler une petite confidence, au cours du Wishathon j’ai reçu un gift venu expressément des USA, c’était un moment très émouvant !

Initier un projet open source

Normalement l’initiation à l’open source devrait s’achever là, mais Kali Academy a souhaité que nous puissions initier aussi des projets open source sur lesquels d’autres personnes vont aussi contribuer. Dans ce cadre, j’ai été mis dans une équipe où on était à trois, moi, mon ami que j’appelle toujours beau frère Firmin NGANDULI et le petit Christian BIREGO, un très bon geek. Ensemble, on a travaillé sur une application nommée LeaderBoard qui compare les contributions des bénévoles sur les projets Wikimédia et les classes en fonction du nombre des contributions. Voici le lien de l’application déployée ici et de la documentation ici… Si vous êtes intéressé par ce projet, dites-le moi aussi en commentaire.

En bref, c’est à ça qu'à ressemblé mon parcours de stage chez Kali Academy, c'était une expérience extrêmement passionnante, j’ai goûté un peu au code professionnel, à l’expertise des grands développeurs open source de Wikimédia… Je remercie Kali Academy pour m’avoir offert cette opportunité, malgré mon niveau et mes faiblesses, je remercie également tous mes collègues avec lesquels on a fait ce parcours ainsi que vous tous qui avez lu cet article jusqu’ici, je vous prie de me faire des corrections en privé s’il en y a 🙂. Ainsi commence mon parcours d’apprenti hacker, à nous revoir dans le future 🙂, étant déjà hackeur 😂

Trois mois à Kali Academy : Une Immersion dans l'Open Source.

Patrice Kalwira — Fri, 14 Jun 2024 20:23:14 +0000

Je m'appelle Patrice Kalwira et je suis un développeur web fullstack.
Cet article est un condensé sur mon parcours en tant que stagiaire au sein de l'organisation Open Source Kali Academy, basée à Goma, à l'Est de la République Démocratique du Congo.
Durant trois mois, j'ai eu l'opportunité exceptionnelle de participer à un stage intensif au sein de Kali Academy, une organisation dynamique spécialisée dans l'open. Cette expérience enrichissante m'a permis de plonger dans les profondeurs de l'open source, de découvrir Kali Academy, ses différents projets et programmes. Plus encore, c'était une immersion totale dans le monde de la Wikimedia Foundation et ses projets mais aussi y apporter ma modeste contribution.

C'est quoi Kali Academy ?
Kali Academy est une académie qui vise à promouvoir les valeurs de l'open source dans les régions les moins représentées notament en Afrique. Les valeurs clés de l'open source sont le partage, la collaboration et bien sûr aussi la contribution. Son cible majeur est les étudiants ainsi que les récents diplômés. Mais il n'oublie pas aussi toute la communauté qui doit être aussi sensibilisée sur l'open source.

Programme de stage
Notre stage a duré trois mois et pour chaque mois nous avions une concentration pricipale particulière

1. Premier mois : Hacking, Linux et projets de Kali Academy

Comment devenir un bon hacker
Comme on aspirait de dévenir tous des hachers, notre voyage a commencé par la formation sur comment devenir un hacker (bien que la plupart des gens confondent hacker et cracker). Nous avons appris les attitudes à adopter.
Introduction au système Linux
La plupart des vrais hackers utilisent Linux comme système d'exploitation. D'où même si on ne va pas forcement utiliser Linux quotidiennement on est sensé avoir en tête quelques commandes.
Présentation des projets de Kali Academy
Nous avons eu des séances sur comment trouver un projet open source passionnant et comment faire pour y contribuer. Notre premier exercice en ce terme était d'aller sur le github de Kali Academy et y choisir quelques issues à travailler.

2. Deuxième mois : Hacking avec MediaWiki
Ce mois visait prémièrement à familiariser les stagiaires au moteur Mediawiki qui propulse la quasi totalité des applications de Wikimedia.
Cette partie a été très capitale car elle nous a permis de commencer à faire des contributions techniques (écriture des codes) directement sur les projets de Wikimedia.
Les projets sur lesquels nous avons passé trop de temps sont Wikipédia et Wikidata. Il y en a eu plusieurs mais ces deux méritent d'être mentionnés ici.
Durant ce mois, nous avons créé un petit moteur de recherche qui récupère des données à partir de Wikidata en utilisant l'API de Wikidata. Ce projet nous a permis de mettre en pratique c'est que nous avons appris dans un événement en ligne qui parlait de Wikidata.

3. Troisième mois : Projet final
Après ces deux mois d'apprentissage, le dernier mois visait à concrétiser tout ce qu'on avait déjà appris en créant des applications.
Pour notre projet final, dans un groupe de 4, nous avons développeé une application qui utilise l'intelligence artificielle pour générer les requêtes SPARQL en utilisant le langage humain.
Le projet est évidemment open source et si ça vous tente, contribuez sans modération.

L'un des points forts de ce stage a été notre participation active à divers hackathons et ateliers organisés par la Wikimedia Foundation, Kiwix, ... Ces événements étaient des occasions idéales pour appliquer les compétences acquises dans des contextes pratiques et collaboratifs. Nous avons travaillé sur des projets divers, allant de l'amélioration des outils existants de Wikimedia à la création de nouvelles applications innovantes. Ces hackathons nous ont également permis de réseauter avec des professionnels de l'industrie et de recevoir des conseils précieux pour notre développement personnel et professionnel.

Voici une liste non exhaustive d'activités dans lequelles nous avons eu l'honneur de participer :

Wishaton March 2024
Wikidata Leveling Up 2024
WMA-MediaWiki 101:Becoming a MediaWiki Hacker
Beacoup d'activités organisées par Wikimedia RDC

Conclusion
Ce stage à Kali Academy a été une expérience transformative, offrant une immersion profonde dans le monde de l'open source, des compétences techniques solides, et l'opportunité de travailler sur des projets innovants avec des applications réelles. Les connaissances et les compétences acquises pendant ces trois mois sont inestimables et ouvrent de nombreuses portes pour des opportunités futures. Kali Academy a fourni un environnement d'apprentissage exceptionnel qui nous a préparés à devenir des contributeurs actifs et innovants dans le domaine de l'open source.
Il y avait beacoup de choses à écrire mais j'ai fait juste un bref résumé. Si vous avez des questions, n'hésitez pas à les poser dans les commentaires
Je remercie toute l'administration de Kali Academy, tous mes collègues stagiaires et tous les contributeurs à l'open source en général quel que soit le projet.

Rapport de Stage chez Kali Academy

Gérard Cubaka — Fri, 14 Jun 2024 17:36:32 +0000

Remerciements

Je tiens à remercier monsieur Abel Mbula CEO de Kali Academy madame Patience Kavira pour l'opportunité de participer à ce stage, ainsi que les formateurs monsieur Delord Wayire et les collegues de la cohort Mars 2024 de Kali Academy spétialement mon binome Firmin Finva et mes coéquipiers du projet Wikidata Query AI, Landry Bitege, Patrice Kalwira et Espoir Birusha pour leur collaboration, leur soutien et leur partage de connaissances.

Introduction

Ce rapport présente mon expérience de stage chez Kali Academy à Goma, en République Démocratique du Congo. Le stage s'est déroulé du 11 mars au 14 Juin 2024 et a été l'occasion de découvrir l'univers du développement open-source et de la culture hacker.

Première leçon : L'attitude hacker

Le premier mois du stage a été consacré à la présentation du concept de hacker, en s'appuyant sur le texte "What is the Hacker & Hacker Attitude" d'Eric Steven Raymond. Ce texte a permis de comprendre la distinction fondamentale entre les hackers et les crackers. Les hackers sont des passionnés de technologie qui construisent et partagent des outils et des ressources, tandis que les crackers sont des individus motivés par des intentions malveillantes.

L'attitude hacker est basée sur cinq principes clés :

Le monde regorge de problèmes fascinants qui attendent d'être résolus.
Aucun problème ne devrait jamais devoir être résolu deux fois.
L'ennui et la corvée sont mauvais.
La liberté est une bonne chose.
L'attitude ne remplace pas la compétence.

En adoptant ces principes, les hackers développent une approche proactive et créative pour résoudre des problèmes et contribuer à l'avancement technologique.

Learn In Public

Le deuxième mois du stage a été consacré au concept de "Learn In Public". Ce concept encourage à partager ses connaissances et à apprendre en permanence en créant du contenu éducatif et en participant à des événements. L'objectif est de ne pas se focaliser sur la reconnaissance extérieure, mais plutôt sur l'amélioration personnelle et l'aide aux autres.

Contribuer sur un issue sur GitHub

Le dernier mois du stage a été consacré à l'apprentissage des étapes à suivre pour contribuer à un problème (issue) sur GitHub. Les étapes clés sont les suivantes :

S'assurer que l'issue est toujours ouverte
Lire les instructions
Fork le dépôt
Cloner le dépôt en local
Créer une branche locale
Effectuer les modifications nécessaires
Commit et push
Créer une Pull Request (PR)
Suivre les commentaires et effectuer les modifications nécessaires
Attendre la validation et fusion

En suivant ces étapes, les contributeurs peuvent apporter des modifications aux projets open-source et participer à leur développement.

Ce stage chez Kali Academy a été une expérience enrichissante qui m'a permis de découvrir la culture hacker et les principes du développement open-source. J'ai également appris à partager mes connaissances et à contribuer à des projets collaboratifs. Je suis reconnaissant envers les formateurs et les membres de la communauté Kali Academy pour leur accueil et leur partage de connaissances.

Prochaines étapes

Je compte mettre en pratique les connaissances acquises lors de ce stage en continuant à apprendre sur le développement open-source et en contribuant à des projets qui me passionnent. Je souhaite également partager mes connaissances avec d'autres personnes en créant du contenu éducatif et en participant à des événements.

Deuxième leçon : Choisir un projet open-source et apprendre les bases de Git

Le deuxième jour du stage a été consacré à deux thématiques importantes :

1. Choisir un projet open-source

La sélection d'un projet open-source sur lequel contribuer est une étape cruciale pour s'impliquer dans la communauté open-source. Pour faire un choix éclairé, il est recommandé de prendre en compte les points suivants :

Intérêts personnels: Orienter le choix vers un projet en adéquation avec ses centres d'intérêt, qu'il s'agisse d'un domaine technologique spécifique, d'un langage de programmation apprécié ou d'une cause qui tient à cœur.
Niveau de compétence: Sélectionner un projet correspondant à son niveau de compétences. Certains projets s'adressent davantage aux débutants, tandis que d'autres exigent des compétences plus avancées.
Taille du projet: Considérer la taille du projet et de sa communauté. Les projets plus petits peuvent offrir une expérience plus collaborative, tandis que les projets plus importants peuvent présenter des opportunités d'apprentissage et de contribution à plus grande échelle.
Problèmes ouverts: Explorer la liste des problèmes ouverts (issues) sur GitHub pour identifier des tâches à réaliser. Certains projets signalent les problèmes adaptés aux nouveaux contributeurs, ce qui peut constituer un bon point de départ.

Ressources pour trouver des projets open-source:

GitHub Explore: Explorer la section "Explore" sur GitHub pour découvrir des projets populaires et en vogue dans divers domaines.
GitHub Topics: Utiliser la fonction "Topics" sur GitHub pour rechercher des projets par catégorie, langage de programmation ou technologie.
Hacktoberfest: Participer à des événements comme Hacktoberfest qui encouragent la contribution à des projets open-source pendant le mois d'octobre.
Sites Web dédiés: Consulter des sites web comme Open Source Friday, Up For Grabs, CodeTriage ou First Timers Only qui répertorient des projets open-source accueillant les nouveaux contributeurs.
Réseaux sociaux et forums: Suivre des comptes et des communautés liés à l'open-source sur les réseaux sociaux, et participer à des forums comme Reddit r/opensource pour découvrir des projets intéressants.

2. Apprendre les bases de Git

Git est un système de contrôle de version essentiel pour le développement open-source. Il permet de suivre les modifications apportées aux fichiers, de collaborer avec d'autres contributeurs et de gérer différentes versions du code. Le stage a permis d'acquérir les connaissances fondamentales pour utiliser Git, notamment :

Création d'un branch: git checkout -b nom_de_la_branche
Navigation dans les fichiers et répertoires: cd, ls, pwd
Création, copie, déplacement et suppression de fichiers et répertoires: touch, mkdir, cp, mv, rm
Affichage du contenu des fichiers: cat, more, less
Recherche de fichiers: find
Changement des permissions des fichiers: chmod
Commandes utiles: grep, wc, head, tail
Utilisation de l'éditeur Nano: nano
Utilisation de l'éditeur Vim: vim

Ressources pour apprendre Git:

Les deux premiers mois du stage ont permis de découvrir les principes fondamentaux du développement open-source, l'importance de la contribution à des projets existants et les outils essentiels pour s'impliquer dans la communauté. Le choix d'un projet adapté et l'apprentissage des bases de Git constituent des étapes préalables importantes pour débuter en tant que contributeur open-source.

Troisième mois : Contribution à un projet open-source et apprentissage de Wikidata

Le troisième mois du stage ont été consacrés à la mise en pratique des connaissances acquises. Les stagiaires ont eu l'opportunité de :

1. Contribuer à un projet open-source

En se basant sur les notions apprises les deux premiers jours, les stagiaires ont choisi un projet open-source auquel ils souhaitaient contribuer. Ils ont suivi les étapes suivantes :

Forker le projet: Ils ont créé une copie du projet sur leur propre compte GitHub.
Cloner le projet en local: Ils ont téléchargé le projet sur leur ordinateur.
Effectuer les modifications: Ils ont apporté des modifications au code du projet en suivant les directives et les besoins du projet.
Tester les modifications: Ils ont testé leurs modifications pour s'assurer qu'elles ne causaient pas de problèmes.
Pusher les modifications: Ils ont envoyé leurs modifications vers leur fork sur GitHub.
Créer une Pull Request: Ils ont soumis une demande de fusion pour que leurs modifications soient intégrées au projet original.

2. Apprendre les bases de Wikidata

Wikidata est une base de données collaborative permettant de stocker et d'interroger des informations structurées. Les stagiaires ont découvert :

La structure de Wikidata: Ils ont compris comment les données sont organisées en triplets sujet-prédicat-objet.
Le langage SPARQL: Ils ont appris à utiliser SPARQL pour interroger les données de Wikidata.
Des exemples de requêtes SPARQL: Ils ont pratiqué la formulation de requêtes pour récupérer des informations spécifiques de Wikidata.

Ressources pour apprendre Wikidata:

Conclusion

Le stage chez Kali Academy a permis aux participants d'acquérir des connaissances fondamentales sur le développement open-source et l'utilisation de Wikidata. Ils ont pu mettre en pratique leurs acquis en contribuant à un projet open-source et en explorant les requêtes SPARQL. Ce stage a constitué une expérience enrichissante et motivante pour les stagiaires, les encourageant à s'impliquer davantage dans la communauté open-source et à poursuivre leur apprentissage dans ce domaine.

Gérard Cubaka Bisimwa
https://ger-cub.github.io/portfoliogerard/

My Journey Internship at Kali Academy

Birusha Ndegeya — Fri, 14 Jun 2024 08:08:55 +0000

I am Birusha Ndegeya, a student software developer specializing in web and mobile apps at Kadea Academy in Goma. During my three-month training at Kali Academy, I dedicated myself to an open-source project and was accepted to dive into the fascinating world of open source.

The internship started on May 11 and ended on June 11 in Goma, North-Kivu, Democratic Republic of Congo. The goal of this internship was to provide practical experience through concrete projects and to train participants on how to contribute to open-source projects and behave within a community.

The Progress of My Internship

The First Month: The Foundation

The first month of our internship was focused on establishing solid foundations. We followed a structured program to become "real" hackers, which included learning in public, using the Linux system, and mastering the command line interface (CLI). We also reviewed Git and GitHub, essential tools for any open-source developer. A highlight of this period was reading the book "Roads and Bridges: The Unseen Labor Behind Our Digital Infrastructure," which profoundly enlightened us about the importance and philosophy of open source.

The Second Month: Specialization in Wikimedia

The second month immersed us in the fascinating world of Wikimedia. We had a quick introduction to Wikipedia and Wikidata and learned how to customize Wikipedia by modifying themes, gadgets, and beta features. We deepened our skills in Wikicode and advanced editing, working on models and templates. We also learned how to create and use Wikidata tools such as the Wikidata REST APIs and SPARQL. This month was crucial for understanding how to effectively contribute to Wikimedia projects and become Mediawiki experts.

The Third Month: Final Projects

In the last month, we were divided into two groups to work on final internship projects. I had the opportunity to participate in an exciting project called "Wiki Data Query AI." This open-source software is designed to help users perform queries on Wikidata without needing to know the SPARQL language. Working on this project allowed me to apply all the skills acquired during the first two months and contribute to a truly innovative tool.

Impact and Reflection

This internship at Kali Academy was a transformative experience. I not only acquired valuable technical skills but also gained a better understanding of the importance of open source. Collaboration with my fellow interns and our mentors also helped me develop essential interpersonal skills, such as teamwork and communication.

I personally thank our mentors Abel Mbula, Delord, and other mentors for dedicating their time and efforts to our training. Along the way, I am truly grateful to my friends who were there to answer my questions. It was a great experience to be among those students. I truly thank them and am ready for other exciting challenges.

Mon aventure en tant que stagiaire chez Kali Academy : Une immersion dans l'open source

Landry Bitege — Fri, 14 Jun 2024 06:42:49 +0000

Je m'appelle Landry Bitege et je suis étudiant en développement web et mobile à Kadea Academy/Goma. Au cours de ma formation, une opportunité exceptionnelle s'est présentée : un stage professionnel de trois mois avec Kali Academy, une organisation dédiée à l'open source. Attiré par le développement logiciel, mais sans expérience préalable dans l'open source, j'ai décidé de relever le défi et de postuler. À ma grande joie, j'ai été accepté, rejoignant une équipe de dix stagiaires prêts à plonger dans cet univers fascinant.

Ce stage, qui s'est déroulé du 11 mars au 11 juin, au sein des installations de GO INNOVATION, situées sur le Boulevard Kanya Mulanga à Goma, Nord-Kivu, avait pour objectif de nous initier aux pratiques de l'open source et de nous permettre de contribuer à des projets concrets. Ce fut bien plus qu'une simple introduction : une véritable aventure enrichissante, tant sur le plan professionnel que personnel.

Le déroulement de mon stage

Le premier mois : La Fondation

Le premier mois de notre stage était axé sur l'établissement de bases solides. Nous avons suivi un programme structuré pour devenir des "vrais" hackers, comprenant l'apprentissage en public, l'utilisation du système Linux, et la maîtrise de la ligne de commande (CLI). Nous avons également révisé Git et GitHub, des outils essentiels pour tout développeur open source. Un des moments forts de cette période fut la lecture du livre "Roads and Bridges: The Unseen Labor Behind Our Digital Infrastructure", qui nous a profondément éclairés sur l'importance et la philosophie de l'open source.

Le deuxième mois : Spécialisation Wikimedia

Le deuxième mois nous a plongés dans l'univers fascinant de Wikimedia. Nous avons eu une introduction rapide à Wikipedia et Wikidata, et avons appris à personnaliser Wikipedia en modifiant les thèmes, gadgets, et fonctionnalités bêta. Nous avons approfondi nos compétences en Wikicode et l'édition avancée, en travaillant sur des modèles et des templates. Nous avons également appris à créer et utiliser des outils des Wikidata comme les API REST de wikidata et les SPARQL. Ce mois était crucial pour comprendre comment contribuer efficacement à des projets Wikimedia et devenir des experts Mediawiki.

Le troisième mois : Projets de Fin de Stage

Pour le dernier mois, nous avons été divisés en deux groupes pour travailler sur des projets de fin de stage. J'ai eu l'opportunité de participer à un projet passionnant nommé "Wiki Data Query AI". Ce logiciel open source est conçu pour aider les utilisateurs à effectuer des requêtes sur Wikidata query sans avoir besoin de connaître le langage SPARQL. Travailler sur ce projet m'a permis d'appliquer toutes les compétences acquises durant les deux premiers mois et de contribuer à un outil véritablement innovant.

Impact et Réflexion

Ce stage chez Kali Academy a été une expérience transformative. J'ai non seulement acquis des compétences techniques précieuses mais aussi une meilleure compréhension de l'importance de l'open source. La collaboration avec mes collègues stagiaires et nos mentors m'a également aidé à développer des compétences interpersonnelles essentielles, telles que le travail en équipe et la communication efficace.

Conclusion

Je tiens à remercier particulièrement mes mentors et collègues pour leur soutien et leurs conseils tout au long de cette aventure. À ceux qui envisagent de suivre ce chemin, je recommande de s'immerger pleinement dans l'expérience, de ne pas hésiter à poser des questions et de toujours chercher à apprendre et à contribuer.

En somme, ce stage a été une expérience inestimable qui a profondément marqué mon parcours personnel et professionnel. J'en ressors enrichi et prêt à relever de nouveaux défis.

Meilleures pratiques pour créer une application Express.js

Landry Bitege — Thu, 13 Jun 2024 14:07:54 +0000

Partie 2 : Meilleures pratiques et fonctionnalités avancées pour créer une application Express.js

Introduction

Pour la 1ère partie, je vous invite à visité l'article où j'ai parler de l'introduction d'express et ses concepts fondamentaux.

Si c'est déjà fait, ici on va voir des notion un peu avancer.

Dans le monde du développement web, il existe une multitude de bibliothèques et de frameworks disponibles pour résoudre une variété de problèmes. Bien que nous abordions certaines des options populaires dans cet article, l'objectif n'est pas de vous prescrire des solutions spécifiques, mais de vous montrer les bonnes pratiques et les concepts qui peuvent être appliqués avec différentes technologies selon vos préférences et vos besoins. Que vous choisissiez Mongoose ou un autre ODM, Passport.js ou une autre solution d'authentification, l'important est de comprendre comment intégrer et utiliser efficacement ces outils pour créer des applications Express.js robustes et évolutives. Explorons maintenant comment structurer et améliorer vos applications Express.js.

1. Structurer une application Express.js de manière organisée et évolutive

Architecture MVC (Model-View-Controller)

Modèles : Les modèles définissent les schémas de données et les interactions avec la base de données. Utilisez Mongoose pour MongoDB, par exemple.

JavaScript

// models/User.js
const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
    name: String,
    email: String,
    password: String,
});

const User = mongoose.model('User', userSchema);
module.exports = User;

Vues : Les vues gèrent les templates et le rendu des pages. Utilisez un moteur de templates comme EJS.

HTML

<!-- views/index.ejs -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Home</title>
</head>
<body>
    <h1>Welcome, <%= user.name %></h1>
</body>
</html>

Contrôleurs : Les contrôleurs contiennent la logique des routes et des actions de l'application.

JavaScript

// controllers/userController.js
const User = require('../models/User');

exports.getUser = async (req, res) => {
    const user = await User.findById(req.params.id);
    res.render('index', { user });
};

Organisation des fichiers et dossiers

Organisez vos fichiers et dossiers de manière structurée pour maintenir la clarté et la facilité de maintenance.

myapp/
├── config/
│   └── config.js
├── controllers/
│   └── userController.js
├── middlewares/
│   └── auth.js
├── models/
│   └── User.js
├── routes/
│   └── userRoutes.js
├── views/
│   └── index.ejs
├── app.js
└── package.json

Utilisation d'un outil de scaffolding

Utilisez des générateurs comme Yeoman pour créer la structure de base de l'application.

Shell

npm install -g yo generator-express
yo express

2. Utiliser des modules et des bibliothèques tierces pour étendre les fonctionnalités d'Express

Mongoose pour MongoDB

Mongoose est un ODM (Object Data Modeling) pour MongoDB et Node.js.

JavaScript

// app.js
const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/myapp', { useNewUrlParser: true, useUnifiedTopology: true });

Passport.js pour l'authentification

Passport.js permet d'implémenter facilement des stratégies d'authentification.

JavaScript

// config/passport.js
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;
const User = require('../models/User');

passport.use(new LocalStrategy(
  async (username, password, done) => {
    const user = await User.findOne({ username });
    if (!user) {
      return done(null, false, { message: 'Incorrect username.' });
    }
    if (!user.validPassword(password)) {
      return done(null, false, { message: 'Incorrect password.' });
    }
    return done(null, user);
  }
));

Socket.io pour les communications en temps réel

Socket.io ajoute des fonctionnalités de WebSockets pour les applications en temps réel.

JavaScript

// app.js
const http = require('http');
const socketIo = require('socket.io');
const server = http.createServer(app);
const io = socketIo(server);

io.on('connection', (socket) => {
    console.log('a user connected');
    socket.on('disconnect', () => {
        console.log('user disconnected');
    });
});

server.listen(3000, () => {
    console.log('listening on *:3000');
});

Helmet pour la sécurité

Helmet aide à sécuriser l'application en configurant divers en-têtes HTTP.

JavaScript

// app.js
const helmet = require('helmet');
app.use(helmet());

Morgan pour la journalisation

Morgan est un middleware de journalisation des requêtes HTTP.

JavaScript

// app.js
const morgan = require('morgan');
app.use(morgan('combined'));

3. Gérer la sécurité des applications Express.js

Protection contre les attaques courantes

Injection SQL : Utilisez des ORM/ODM sécurisés et des requêtes paramétrées.

JavaScript

// Using Mongoose to avoid SQL injection
const user = await User.findOne({ username: req.body.username });

Cross-Site Scripting (XSS) : Échappez les données de l'utilisateur et utilisez des bibliothèques comme [xss-clean](https://www.npmjs.com/package/xss-clean).

JavaScript

const xss = require('xss-clean');
app.use(xss());

Cross-Site Request Forgery (CSRF) : Utilisez des tokens CSRF pour protéger les formulaires.

JavaScript

const csrf = require('csurf');
const csrfProtection = csrf({ cookie: true });
app.use(csrfProtection);

// In your route
app.get('/form', (req, res) => {
    res.render('send', { csrfToken: req.csrfToken() });
});

Mise à jour des dépendances

Utilisez npm audit et nsp pour vérifier et corriger les vulnérabilités.

Shell

npm audit

Configurer HTTPS

Utilisez Let's Encrypt pour obtenir des certificats SSL/TLS gratuits.

JavaScript

const fs = require('fs');
const https = require('https');
const options = {
    key: fs.readFileSync('/path/to/key.pem'),
    cert: fs.readFileSync('/path/to/cert.pem')
};

https.createServer(options, app).listen(443);

4. Déployer et mettre à l'échelle une application Express.js

Héberger sur des plateformes cloud

Des plateformes comme Render, AWS, Heroku, et DigitalOcean facilitent le déploiement.

Shell

# Exemple de déploiement sur Heroku
heroku create
git push heroku master

Utilisation de Docker

Conteneurisez l'application pour un déploiement portable et reproductible.

# Dockerfile
FROM node:14
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "app.js"]

Load balancing et scaling

Configurez un load balancer pour répartir le trafic et utilisez des outils comme PM2 pour gérer les processus Node.js.

Shell

# PM2
npm install pm2 -g
pm2 start app.js -i max

5. Bonnes pratiques pour le développement avec Express.js

Tests unitaires et d'intégration

Utilisez Mocha, Chai et Supertest pour écrire et exécuter des tests.

JavaScript

// test/user.test.js
const request = require('supertest');
const app = require('../app');

describe('GET /user', () => {
    it('responds with json', (done) => {
        request(app)
            .get('/user')
            .set('Accept', 'application/json')
            .expect('Content-Type', /json/)
            .expect(200, done);
    });
});

Documentation

Utilisez des outils comme Swagger pour documenter les API.

JavaScript

const swaggerUi = require('swagger-ui-express');
const swaggerDocument = require('./swagger.json');

app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

Optimisation des performances

Mise en cache avec Redis ou Memcached :

JavaScript

const redis = require('redis');
const client = redis.createClient();

app.get('/data', (req, res) => {
    client.get('data', (err, data) => {
        if (data) {
            res.send(data);
        } else {
            // Fetch data from database
            const newData = fetchDataFromDatabase();
            client.setex('data', 3600, newData);
            res.send(newData);
        }
    });
});

Optimiser les requêtes à la base de données :

Assurez-vous que vos requêtes sont optimisées et utilisez des index là où c'est nécessaire.

Utiliser des middlewares de compression comme [compression](https://www.npmjs.com/package/express-compression) :

JavaScript

const compression = require('compression');
app.use(compression());

Conclusion

En suivant ces bonnes pratiques et en utilisant des fonctionnalités avancées, vous pouvez créer des applications Express.js robustes, sécurisées et évolutives. La structuration de votre code, l'utilisation de modules tiers, la gestion de la sécurité, le déploiement efficace et les tests rigoureux sont essentiels pour développer des applications performantes et maintenables. Continuez à explorer et à intégrer ces pratiques dans vos projets pour améliorer constamment la qualité de vos applications.

Voici quelques ressources supplémentaires qui pourraient vous aidez à continuer votre apprentissage :

La documentation officielle d'Express.js sur les bonne pratiques de la securité en production
Tutoriels et articles sur Express.js :
Livres sur Express.js :
- "Learning Express" de Carlos Rios
- "Building Node.js Applications" de Ryan Tozier et Ashish Goel
Rejoignez la communauté Express.js : Participez à des forums et des groupes en ligne pour poser des questions, partager vos expériences et apprendre des autres développeurs.
Construisez vos propres applications : La meilleure façon d'apprendre est de mettre la main à la pâte. Commencez par créer des applications simples et progressez vers des projets plus complexes.

N'oubliez jamais que l'apprentissage est un processus continu. Restez curieux, explorez et créez, et vous deviendrez un maître du développement d'applications Express.js !