Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
omahs authored Oct 28, 2023
1 parent bda8f99 commit 294510e
Show file tree
Hide file tree
Showing 5 changed files with 15 additions and 15 deletions.
8 changes: 4 additions & 4 deletions additional-material/Things a non Programmer can do.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ It's the primary conduit of communication between the users and the developers.
You may need to get special permissions in the ticketing system, which most project leaders will be glad to give you when you say you want to help clean up the tickets.

4. **Diagnose a bug**: Bugs are often poorly reported.
Diagnosing and triaging a bug can help save the developers save time with the legwork of figuring out the specifics of the problem.
Diagnosing and triaging a bug can help save the developers time with the legwork of figuring out the specifics of the problem.
If a user reported, "The software doesn't work when I do X," spend some time to figure out the specifics of what goes into that problem.
Is it repeatable? Can you create a set of steps to cause the problem repeatedly? Can you narrow down the problem, such as only happening on one browser but not another, or one distro but not another?

Expand Down Expand Up @@ -76,7 +76,7 @@ Then, add a test to the suite to cover it.
9. **Silence a compiler warning**: The build process for many C-based projects often spew the odd compiler warning flag to the screen.
These warnings are usually not indicators of a problem, but they can look like it.
Having too many warnings can make the compiler sound like it's crying wolf.
Check to see if the code could actually be hiding a bug.If not, modifying the source to silence helps to hide these false positives.
Check to see if the code could actually be hiding a bug. If not, modifying the source to silence helps to hide these false positives.

10. **Add a comment**:
When you're digging through the code, you may find some spots that are confusing.
Expand Down Expand Up @@ -115,10 +115,10 @@ Perhaps the project could use a graphic overhaul, or a logo to identify the proj
These may be skills lacking in the community. I know I'd love it if I could get some graphic design help on my projects' websites.

15. **Write technical documentation**
If you can write about how an application or piece of software works, you could write technical documentation about it. Especially open source projects that are looking to update, revamp, expand, or create technical docs for the general public to read. The more you write in plain english, the better. The best part, you don't have to be a programmer to write techincal docs.
If you can write about how an application or piece of software works, you could write technical documentation about it. Especially open source projects that are looking to update, revamp, expand, or create technical docs for the general public to read. The more you write in plain english, the better. The best part, you don't have to be a programmer to write technical docs.

Most of all, listen to what people around you discuss. See if you can recognize a pressing need. For instance, recently on the Parrot developers' mailing list, it was decided to use GitHub as the trouble ticket system, abandoning the old Trac installation they had. Some people were against the move because there was no way to convert the tickets to GitHub's system. After a day of back and forth arguing, I piped up and said "How about if I write a converter?" People were thrilled at the idea. I spent the time to write a conversion program for the 450+ tickets, so we lost none of our ticket history. It was a great success. I got to pitch in, and the core developers stayed focused on the business of working on Parrot.

15. **Teach and Help others**:
The best way to learn more about a topic is to try to teach it.
The best teach is the one who can explain complex stuff with simple examples. So you need to try to be the best teacher to be the best learner and the best in your programming world. Teaching others will make you feel better about yourself and it will help you get better skills and knowledge in your profession. When you get Help from someone don't keep it to yourself share it with the others. Make the world a better place to live.
The best teacher is the one who can explain complex stuff with simple examples. So you need to try to be the best teacher to be the best learner and the best in your programming world. Teaching others will make you feel better about yourself and it will help you get better skills and knowledge in your profession. When you get help from someone don't keep it to yourself share it with others. Make the world a better place to live.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Additional information
# Informations supplémentaires
Nous partons du principe que vous avez déjà lu le tutoriel basique avant de vous rendre ici. Ce document vous donnera des informations complémentaires
sur les techniques avancées de Git.

Expand Down Expand Up @@ -34,16 +34,16 @@ Cette page vous donnera les informations dont vous avez besoin pour résoudre le
Cette page vous aidera si vous avez besoin de revenir à un commit précédent, sur le répertoire distant. Ceci est pratique dans le cas où vous auriez besoin d'annuler un commit que vous auriez déjà poussé sur Github.
> Suivez ces étapes si vous souhaitez reprendre un commit.
### [Applatir des Commits](squashing-commits.md)
Cette page vous apprendra comment applatir plusieurs commits en un seul.
> A utiliser si vous voulez ouvrir une demande de révision (pull request) et que l'évaluateur vous demande d'"applatir" tous les commits en un seul, contenant un message d'information global.
### [Aplatir des Commits](squashing-commits.md)
Cette page vous apprendra comment aplatir plusieurs commits en un seul.
> A utiliser si vous voulez ouvrir une demande de révision (pull request) et que l'évaluateur vous demande d'"aplatir" tous les commits en un seul, contenant un message d'information global.
### [Annuler un commit local](undoing-a-commit.md)
Cette page vous donne les informations dont vous avez besoin pour annuler un commit sur votre répertoire local. C'est ce que vous aurez besoin de faire si vous sentez que vous avez fait une erreur dans votre répertoire local et que vous voulez revenir à l'état précédent.
> Suivez ces instructions si vous voulez annuler / revenir à l'état précédent sur un commit local.
### [liens utiles](Useful-links-for-further-learning.md)
Cette page est dédiée à tous les sites de trucs et astuces, les blogs, et en règle générale les site qui nous aident à rendre nos vies plus faciles. Ils sont d'excellentes références pour répondre à tous vos besoins, que vous soyez débutant ou expert. Cette page devrait être un index de tous ces liens utiles qui aideront tous ceux qui sont nouveaux dans le domaine de l'open-source ou ceux qui veulent approfondir leurs connaissances.
Cette page est dédiée à tous les sites de trucs et astuces, les blogs, et en règle générale les sites qui nous aident à rendre nos vies plus faciles. Ils sont d'excellentes références pour répondre à tous vos besoins, que vous soyez débutant ou expert. Cette page devrait être un index de tous ces liens utiles qui aideront tous ceux qui sont nouveaux dans le domaine de l'open-source ou ceux qui veulent approfondir leurs connaissances.

### [Créer un fichier .gitignore](creating-a-gitignore-file.md)
Ce document explique à quoi sert un fichier .gitignore, pourquoi l'utiliser et comment le créer. Ce fichier est utilisé dans quasiment tous les projets git. Il aide à ne prendre en compte dans les commits que les fichiers nécessaires.
6 changes: 3 additions & 3 deletions cli-tool-tutorials/git-bash-windows-tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@ To clone the repo, click on "Code" and then copy the string down below.

<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />

Open the git bash application you just downloaded. It should look like the image down below if its on a windows machine.
Open the git bash application you just downloaded. It should look like the image down below if it's on a windows machine.

<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />

Go to the folder that you want to save this project on by uisng this command
Go to the folder that you want to save this project on by using this command

`cd <folder>`

Expand All @@ -53,7 +53,7 @@ Go to the directory where the repo is and open it up on vs code to make your cha

## Create a branch

Now create a branch by uing this simple command. This command not only creates a branch for you but also lets you switch to that branch.
Now create a branch by using this simple command. This command not only creates a branch for you but also lets you switch to that branch.

```
git checkout -b <branch-name>
Expand Down
2 changes: 1 addition & 1 deletion gui-tool-tutorials/sourcetree-macos-tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Reading articles & watching tutorials can help, but what comes better than actua

## Sourcetree

Please note, this tutorial is for MacOS. It is similar with Sourcetree on Windows but some things may look different.
Please note, this tutorial is for MacOS. It is similar to Sourcetree on Windows but some things may look different.
<!--
****************************************
*** This is commented out until ***
Expand Down
4 changes: 2 additions & 2 deletions translations/README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Cela va créer une copie du répertoire sur votre compte.

<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clonez ce répertoire" />

Maintenant, clonez ce répertoire sur votre ordinateur. Cliquez sur le bouton clone puis cliquez sur l'icone *copier dans le presse-papier*.
Maintenant, clonez ce répertoire sur votre ordinateur. Cliquez sur le bouton clone puis cliquez sur l'icône *copier dans le presse-papier*.

Ouvrez une invite de commande (si vous êtes sous Windows) ou un terminal (si vous êtes sous MacOS ou Linux) et exécutez les commandes git suivantes :

Expand Down Expand Up @@ -109,7 +109,7 @@ Ceci est une manière de dire à git qu'une autre version de ce répertoire exis
git fetch upstream
```

Ici nous cherchons toutes les modification dans mon embranchement (upstream remote). Maintenant, vous devez fusionner la nouvelle révision de mon répertoire avec votre branche main :
Ici nous cherchons toutes les modifications dans mon embranchement (upstream remote). Maintenant, vous devez fusionner la nouvelle révision de mon répertoire avec votre branche main :
```
git rebase upstream/main
```
Expand Down

0 comments on commit 294510e

Please sign in to comment.