Git and GitHubGit وGitHub

Everyone invents the same bad system: a folder of files ending in -v2, -final and -final-FIXED. Git is what happens when you take that instinct seriously and build it properly.

الجميع يخترع النظام السيئ نفسه: مجلد ملفات تنتهي بـ-v2 و-final و-final-FIXED. وgit هو ما يحدث حين تأخذ تلك الغريزة على محمل الجد وتبنيها كما ينبغي.

Two commands to check it is there, and three to configure it. The name and email you set here are stamped on every commit you will ever make, so it is worth getting right the first time.

أمران للتحقق من وجوده، وثلاثة لضبطه. والاسم والبريد اللذان تضبطهما هنا مختومان على كل commit ستصنعها، فيستحقان الضبط الصحيح من أول مرة.

Turning a folder into a project git tracks takes one command and adds one hidden directory. Knowing what is inside that directory is what makes everything afterwards stop feeling like magic.

تحويل مجلد إلى مشروع يتتبعه git يحتاج أمرًا واحدًا ويضيف مجلدًا مخفيًا واحدًا. ومعرفة ما داخل ذلك المجلد هي ما يجعل كل ما بعده يكفّ عن الشعور بالسحر.

Almost every confusing thing about git comes from not knowing this. A file is in your folder, or staged, or committed — and each command moves it between exactly two of those.

كل ما يحيّر في git تقريبًا يأتي من عدم معرفة هذا. فالملف إما في مجلدك، أو مجهَّز، أو مودَع — وكل أمر ينقله بين اثنين منها بالضبط.

It tells you where you are, what has changed, what is staged and what git suggests you do next. Run it constantly — it is free, it changes nothing, and it prevents most beginner mistakes.

يخبرك أين أنت، وما الذي تغيّر، وما المجهَّز، وبم يقترح git أن تفعل بعدها. نفّذه باستمرار — فهو مجاني ولا يغيّر شيئًا ويمنع معظم أخطاء المبتدئين.

One command moves a change from your folder into the staging area. The interesting part is not the command — it is deciding what belongs together in one commit.

أمر واحد ينقل تغييرًا من مجلدك إلى منطقة التجهيز. والجزء المثير ليس الأمر — بل تقرير ما الذي ينتمي معًا في commit واحدة.

The command is short. The message is the part that matters, because it is the only thing explaining why — and in six months you will be the stranger reading it.

الأمر قصير. والرسالة هي الجزء المهم، لأنها الشيء الوحيد الذي يشرح لماذا — وبعد ستة أشهر ستكون أنت الغريب الذي يقرؤها.

The history is only useful if you can search it. One command shows it, and a handful of options turn it into an answer to "when did this break, and who changed it?"

التاريخ لا ينفع إلا إن استطعت البحث فيه. وأمر واحد يعرضه، وحفنة خيارات تحوّله إلى جواب لسؤال "متى انكسر هذا، ومن غيّره؟"

Some files should never enter the history: passwords, generated output, and other people's code. One file lists them, and getting it right before the first commit saves a great deal of pain.

بعض الملفات يجب ألا تدخل التاريخ أبدًا: كلمات المرور، والمخرَجات المولَّدة، وشيفرة الآخرين. وملف واحد يعدّدها، وضبطه قبل أول commit يوفّر ألمًا كثيرًا.

Three commands with similar names that do very different things. Choosing between them is entirely a question of which of the three places you are undoing, and whether anyone else has seen it.

ثلاثة أوامر بأسماء متشابهة تفعل أشياء شديدة الاختلاف. والاختيار بينها كله سؤال عن أي المواضع الثلاثة تتراجع عنه، وهل رآه أحد غيرك.

People imagine a branch is a copy of the project. It is not — it is a sticky note with a commit written on it, and knowing that makes everything about branching straightforward.

يتخيل الناس أن الـbranch نسخة من المشروع. وليس كذلك — بل ورقة لاصقة مكتوب عليها commit، ومعرفة ذلك تجعل كل ما يخص التفريع بسيطًا.

Two commands, and one surprise: switching branches changes the files in your folder. Your editor will show different content, and nothing is lost.

أمران، ومفاجأة واحدة: التبديل بين branches يغيّر الملفات في مجلدك. فسيعرض محررك محتوى مختلفًا، ولا شيء يضيع.

You know how to make one. This is the part nobody explains: what branches are actually for, and the small set of habits that make them useful rather than a filing system you fight with.

تعرف كيف تصنع واحدة. وهذا هو الجزء الذي لا يشرحه أحد: ما وظيفة الـbranches فعلًا، والمجموعة الصغيرة من العادات التي تجعلها نافعة لا نظام حفظ تصارعه.

Merging joins a branch back into another. It happens in one of two ways depending on whether the other branch moved while you were away — and knowing which you are getting explains the output.

الدمج يصل branch بأخرى. ويحدث بإحدى طريقتين بحسب هل تحركت الأخرى وأنت غائب — ومعرفة أيهما ستحصل عليها تفسّر المخرَج.

A conflict is not an error and nothing is broken. It is git saying two people changed the same lines and it will not guess which is right — so it hands the decision to you.

التعارض ليس خطأً ولا شيء معطل. بل هو git يقول إن شخصين غيّرا الأسطر نفسها ولن يخمّن أيهما صحيح — فيسلّم القرار إليك.

Fifteen lessons with no internet connection. GitHub adds one thing — a copy of your repository that other machines can reach — and then a great deal built on top of that one thing.

خمسة عشر درسًا بلا اتصال بالإنترنت. ويضيف GitHub شيئًا واحدًا — نسخة من مستودعك تستطيع أجهزة أخرى بلوغها — ثم الكثير مبنيًا فوق ذلك الشيء الواحد.

GitHub will not take your password on the command line, and that surprises people. There are two accepted ways to prove who you are, and one of them you already set up in the terminal course.

لن يقبل GitHub كلمة مرورك في سطر الأوامر، وهذا يفاجئ الناس. وثمة طريقتان مقبولتان لإثبات من أنت، وإحداهما جهّزتها بالفعل في دورة الطرفية.

Three commands move commits between your machine and the remote. They are the whole of working with GitHub — everything else on the site is built on top of these.

ثلاثة أوامر تنقل الـcommits بين جهازك والـremote. وهي كل العمل مع GitHub — وكل ما عداها في الموقع مبني فوقها.

A pull request is a branch, proposed. It says "here is some work, please look at it before it becomes part of the project" — and it is how essentially all professional software is written.

الـpull request هو branch مقترحة. تقول "هذا عمل، فانظر فيه قبل أن يصير جزءًا من المشروع" — وهكذا تُكتب كل البرمجيات الاحترافية تقريبًا.

The other half of the workflow: reading someone else's change, saying something useful about it, and pressing the button. Reviewing well is a skill, and it is mostly about how you write.

النصف الآخر من سير العمل: قراءة تغيير شخص آخر، وقول شيء نافع عنه، وضغط الزر. والمراجعة الجيدة مهارة، وهي في معظمها عن كيف تكتب.

You cannot push to a repository you do not have write access to — which is almost all of them. A fork is your own copy on GitHub, and it is how every outside contribution is made.

لا تستطيع الدفع إلى مستودع لا تملك حق الكتابة فيه — وهي كلها تقريبًا. والـfork نسختك أنت على GitHub، وبه يُقدَّم كل إسهام خارجي.

Twenty-one lessons of individual commands, assembled into the small loop you will actually run every day — and one table for the moments when something has gone wrong.

واحد وعشرون درسًا من أوامر مفردة، مجمَّعة في الحلقة الصغيرة التي ستنفّذها كل يوم فعلًا — وجدول واحد للحظات التي يسوء فيها شيء.

The last lesson introduces nothing. Take a site you built, put it on GitHub properly, and make one real improvement to it through the full branch-review-merge cycle.

الدرس الأخير لا يقدّم جديدًا. خذ موقعًا بنيته، وضعه على GitHub كما ينبغي، وأجرِ تحسينًا حقيقيًا واحدًا عليه عبر دورة branch ومراجعة ودمج كاملة.