GitHub and Teamwork: Remotes, Pull Requests and IssuesGitHub و کاری تیمی: کۆگاکانی کۆدی دوور، داواکارییەکانی بەیەککردن و ئیشووەکان

At the end of Branches and merging, the whole history of Bazaar Cart lives in one folder on Karwan's laptop — one computer played the whole team there. Shilan, Aram and Dilan cannot see those commits from their own laptops, and if the laptop is stolen or breaks, weeks of work are gone. The team needs one shared copy that everyone can reach, day and night: a remote repository.

لە کۆتایی لقەکان و بەیەککردن، هەموو مێژووی Bazaar Cart لە یەک فۆڵدەردا (Directory) لەسەر لاپتۆپەکەی کاروانە — لەوێ یەک کۆمپیوتەر ڕۆڵی هەموو تیمەکەی دەبینی. شیلان، ئارام و دیلان لە لاپتۆپی خۆیانەوە ئەو کۆمیتانە نابینن و ئەگەر لاپتۆپەکە بدزرێت یان تێک بچێت، کاری چەند هەفتەیەک ون دەبێت. تیمەکە پێویستی بە یەک کۆپیی هاوبەشە کە هەمووان شەو و ڕۆژ پێی بگەن: کۆگای کۆدی دوور.

Websites that keep remote repositories for teams are called code hosting services. GitHub, GitLab, Bitbucket and Codeberg are well known, and all of them use Git, so the commands of this lesson work with each one. GitHub is the biggest: Microsoft has owned it since 2018, and its Octoverse report counted more than 180 million developers and about 630 million repositories in 2025. Keep the two names apart: Git is the tool on your computer (Git basics); GitHub is a website that keeps Git repositories and adds teamwork tools around them.

ئەو تۆڕگانەی (Website) کۆگاکانی کۆدی دوور بۆ تیمەکان هەڵدەگرن پێیان دەوترێت خزمەتگوزاریی هەڵگرتنی کۆد. GitHub، GitLab، Bitbucket و Codeberg ناسراون و هەموویان Git بەکار دەهێنن، بۆیە فەرمانەکانی (Command) ئەم وانەیە لەگەڵ هەر یەکێکیان کار دەکەن. GitHub گەورەترینیانە: لە ⁦2018⁩ـەوە هی Microsoftـە و ڕاپۆرتی Octoverseـی ساڵی ⁦2025⁩ زیاتر لە ⁦180⁩ ملیۆن بەرنامەساز (Software developer) و نزیکەی ⁦630⁩ ملیۆن کۆگای کۆد ژماردووە. ئەم دوو ناوە تێکەڵ مەکە: Git ئامرازەکەیە لەسەر کۆمپیوتەرەکەت (بنەماکانی Git)؛ GitHub تۆڕگەیەکە کە کۆگاکانی کۆدی Git هەڵدەگرێت و ئامرازی کاری تیمیان بۆ زیاد دەکات.

A remote is another copy of your repository that your Git knows by a short name; the usual name is origin. In this lesson GitHub is played by a folder on your own computer, so you can try every command with no account and no internet. git init --bare makes a bare repository: only the history, with no working files to edit — exactly what a server keeps. Karwan makes one, connects his project to it and sends his commits up — and the tag v0.2.0 from Branches and merging too:

کۆگای کۆدی دوور کۆپییەکی ترە لە کۆگای کۆدەکەت کە Gitـەکەت بە ناوێکی کورت دەیناسێت؛ ناوە باوەکەی originـە. لەم وانەیەدا فۆڵدەرێک لەسەر کۆمپیوتەرەکەی خۆت ڕۆڵی GitHub دەبینێت، بۆیە دەتوانیت هەموو فەرمانێک بێ هەژماری بەکارهێنەر (User account) و بێ ئینتەرنێت (Internet) تاقی بکەیتەوە. git init --bare کۆگایەکی کۆدی ڕووت دروست دەکات: تەنیا مێژووەکە، بێ فایلەکانی (File) کار بۆ دەستکاریکردن — ڕێک ئەوەی ڕاژەکارێک (Server) هەڵی دەگرێت. کاروان یەکێک دروست دەکات، پڕۆژەکەی پێیەوە دەبەستێت و کۆمیتەکانی خۆی دەنێرێتە سەرەوە — هەروەها تاگی Git (Tag) v0.2.0 لە لقەکان و بەیەککردن:

Shilan starts on her own laptop. git clone copies the remote repository — every file, every commit, every branch — and remembers where it came from as origin. Because all three people share one computer in our stand-in, each clone gets its own author name with git config without --global, which changes only this repository:

شیلان لەسەر لاپتۆپەکەی خۆی دەست پێدەکات. git clone کۆگای کۆدی دوور کۆپی دەکات — هەموو فایلێک، هەموو کۆمیتێک، هەموو لقێک — و لەبیری دەمێنێت لە کوێوە هاتووە، بە ناوی origin. لەبەر ئەوەی لە جێگرەوەکەماندا هەر سێ کەسەکە یەک کۆمپیوتەر بەکار دەهێنن، هەر کلۆنێک ناوی نووسەری تایبەتی خۆی وەردەگرێت بە git config بەبێ --global، کە تەنیا ئەم کۆگای کۆدە دەگۆڕێت:

remotes/origin/main is a remote-tracking branch: Git's note of where main was on the remote the last time you talked to it. It moves only when you fetch, pull or push.

remotes/origin/main لقێکی بەدواداچوونی دوورە (Remote-tracking branch): تێبینیی Gitـە کە دواجار کە قسەت لەگەڵ کۆگای کۆدی دوور کرد main لە کوێ بوو. تەنیا کاتێک دەجووڵێت کە fetch، پوڵ یان پوش دەکەیت.

Shilan writes a README.md and commits it. git status now compares her branch with her note of the remote and says she is ahead by 1 commit. git push sends that commit to origin; the line bf0326b..62f2cfe shows the remote main moving from the old commit to the new one.

شیلان README.mdێک دەنووسێت و کۆمیتی دەکات. ئێستا git status لقەکەی بەراورد دەکات لەگەڵ تێبینییەکەی لەبارەی کۆگای کۆدی دوور و دەڵێت 1 کۆمیت لە پێشە. git push ئەو کۆمیتە دەنێرێت بۆ origin؛ دێڕی bf0326b..62f2cfe پیشان دەدات mainـی کۆگای کۆدی دوور لە کۆمیتە کۆنەکەوە بۆ نوێیەکە دەجووڵێت.

On his laptop Karwan knows nothing yet. git fetch only downloads: it moves his note origin/main forward and leaves his files alone, so he can look first. git pull does a fetch and then merges origin/main into his branch. Here nobody else changed main, so the merge is a simple fast-forward:

کاروان لەسەر لاپتۆپەکەی هێشتا هیچ نازانێت. git fetch تەنیا دادەبەزێنێت: تێبینییەکەی origin/main بەرەو پێش دەبات و فایلەکانی بەجێ دەهێڵێت، بۆ ئەوەی سەرەتا سەیر بکات. git pull fetch دەکات و پاشان origin/main لەگەڵ لقەکەی بەیەک دەکات. لێرەدا کەسی تر mainـی نەگۆڕیوە، بۆیە بەیەککردنەکە سادەیە: بەیەککردنی بەپێشخستن

Next morning both work at the same time. Karwan makes cart.py read the order from the command line and pushes first. Shilan, who has not pulled, adds the price rules to the README and pushes a minute later. Git refuses:

بەیانیی دواتر هەردووکیان لە هەمان کاتدا کار دەکەن. کاروان وا لە cart.py دەکات داواکارییەکە لە نێوبەستەی هێڵی فەرمان (Command-line interface) بخوێنێتەوە و یەکەم کەس پوش دەکات. شیلان، کە پوڵی نەکردووە، یاساکانی نرخ بۆ README زیاد دەکات و خولەکێک دواتر پوش دەکات. Git ڕەتی دەکاتەوە:

Nothing is broken. The remote main now has Karwan's commit, which Shilan does not have. If Git accepted her push, main would jump to her commit and Karwan's work would fall out of the history. So Git asks her to fetch first, join both lines of work, and push again.

هیچ شتێک تێک نەچووە. ئێستا mainـی کۆگای کۆدی دوور کۆمیتەکەی کاروانی تێدایە کە شیلان نییەتی. ئەگەر Git پوشەکەی ئەوی وەربگرتایە، main بازی دەدا بۆ سەر کۆمیتەکەی ئەو و کارەکەی کاروان لە مێژووەکە دەکەوتە دەرەوە. بۆیە Git داوای لێدەکات سەرەتا fetch بکات، هەردوو هێڵی کارەکە بەیەک بکات و پاشان دووپاتە پوش بکات.

Shilan runs git pull. The first time, Git 2.50 stops and asks how two lines of work should be joined. This course uses merge, the method from Branches and merging, so she sets it once for all her projects and pulls again:

شیلان git pull جێبەجێ دەکات. یەکەم جار ⁦Git 2.50⁩ ڕادەوەستێت و دەپرسێت دوو هێڵی کار چۆن بەیەک بکرێن. ئەم خولە بەیەککردن بەکار دەهێنێت، ڕێگەکەی لقەکان و بەیەککردن، بۆیە یەک جار بۆ هەموو پڕۆژەکانی دیاری دەکات و دووپاتە پوڵ دەکات:

Everything above works the same with GitHub; only the address changes. A GitHub account is optional in this course: GitHub's Terms of Service (in force since 27 April 2026) say you must be 13 or older, and one person may keep only one free personal account. When the team is ready, Aram, the team lead, presses New repository, types the name, chooses Private, leaves Add a README unticked — Karwan's project already has a history — and invites the team as collaborators. In a real project there is no practice folder: Karwan connects his repository to GitHub and pushes with the commands below. They are a labelled example, not run here:

هەموو ئەوەی سەرەوە بە هەمان شێوە لەگەڵ GitHub کار دەکات؛ تەنیا ناونیشانەکە دەگۆڕێت. هەژماری بەکارهێنەری GitHub لەم خولەدا ئارەزوومەندانەیە: مەرجەکانی خزمەتگوزاریی GitHub (کە لە ⁦27⁩ی نیسانی ⁦2026⁩ـەوە کاریان پێدەکرێت) دەڵێن دەبێت تەمەنت ⁦13⁩ ساڵ یان زیاتر بێت و هەر کەسێک تەنیا یەک هەژماری کەسیی بێبەرانبەری هەبێت. کاتێک تیمەکە ئامادە بوو، ئارام، سەرۆکی تیمەکە، New repository دادەگرێت، ناوەکە دەنووسێت، Private هەڵدەبژێرێت، Add a README بەتاڵ دەهێڵێتەوە — پڕۆژەکەی کاروان پێشتر مێژووی هەیە — و تیمەکە وەک هاوکار بانگهێشت دەکات. لە پڕۆژەیەکی ڕاستەقینەدا فۆڵدەری ڕاهێنان نییە: کاروان کۆگای کۆدەکەی بە GitHubـەوە دەبەستێت و بەم فەرمانانەی خوارەوە پوش دەکات. نموونەیەکی ناونووسکراون، لێرە جێبەجێ نەکراون:

Git then asks you to sign in. GitHub stopped accepting account passwords for Git on 13 August 2021. Use a personal access token (a long secret you create in your GitHub settings and paste when Git asks for a password), an SSH key, or a helper that signs you in through the browser: Git Credential Manager, GitHub Desktop or the gh tool. A token is as powerful as a password: never put it in code, a chat or a screenshot, and turn on two-factor authentication.

پاشان Git داوات لێدەکات بچیتە ژوورەوە. GitHub لە ⁦13⁩ی ئابی ⁦2021⁩ـەوە چیتر تێپەڕەوشەی هەژماری بەکارهێنەر بۆ Git وەرناگرێت. تۆکنێکی چوونەژوورەوەی کەسی بەکار بهێنە (نهێنییەکی درێژ کە لە ڕێکخستنەکانی GitHub دروستی دەکەیت و کاتێک Git داوای تێپەڕەوشە دەکات دایدەنێیت)، کلیلی SSH، یان یاریدەدەرێک کە لە ڕێی تۆڕگەڕەوە (Web browser) دەتباتە ژوورەوە: Git Credential Manager، GitHub Desktop یان ئامرازی gh. تۆکنێکی چوونەژوورەوە بە قەد تێپەڕەوشەیەک بەهێزە: هەرگیز مەیخەرە ناو کۆد، چات یان وێنەی شاشە (Screenshot) و پشتڕاستکردنەوەی دوو قۆناغی هەڵبکە.

GitHub shows a repository's README.md on its front page, so it is the first thing a visitor reads. GitHub suggests it answers five questions: what the project does, why it is useful, how to start, where to get help, and who works on it. It is written in Markdown: plain text with a few symbols — # for a heading, - for a list item, **bold**, and three back-ticks around a block of code.

GitHub README.mdـی هەر کۆگایەکی کۆد لە پەڕەی سەرەکییەکەیدا پیشان دەدات، بۆیە یەکەم شتە کە سەردانکەرێک دەیخوێنێتەوە. GitHub پێشنیار دەکات وەڵامی پێنج پرسیار بداتەوە: پڕۆژەکە چی دەکات، بۆچی بەسوودە، چۆن دەست پێبکەیت، لە کوێ یارمەتی وەربگریت و کێ کاری لەسەر دەکات. بە Markdown دەنووسرێت: دەقی سادە لەگەڵ چەند هێمایەک — # بۆ سەردێڕ (Heading)، - بۆ خاڵێکی لیست، **bold** و سێ ⁦back-tick⁩ بە دەوری بلۆکێکی کۆددا.

Two more files usually sit next to it. A LICENSE file says what others may do with the code; without one, the code is not free to reuse, even in a public repository — choosing a licence is explained in Software licences. A .gitignore keeps caches and secrets out of Git, as in Git basics; GitHub offers ready templates, such as one for Python.

دوو فایلی تر زۆرجار لە تەنیشتیەوەن. فایلی LICENSE دەڵێت ئەوانی تر چی دەتوانن بە کۆدەکە بکەن؛ بەبێ ئەوە کۆدەکە بۆ دووپاتە بەکارهێنان ئازاد نییە، تەنانەت لە کۆگایەکی کۆدی گشتیدا — هەڵبژاردنی مۆڵەتێکی بەکارهێنان لە مۆڵەتەکانی بەکارهێنان ڕوون کراوەتەوە. .gitignore کاش و نهێنییەکان لە Git دوور دەخاتەوە، وەک لە بنەماکانی Git؛ GitHub قاڵبی ئامادە پێشکەش دەکات، وەک یەکێک بۆ Python.

Dilan, the team's tester, clones the newest main and tries an order the way Soran types it — with a capital letter:

دیلان، تاقیکەرەوەی نەرمەواڵەی (Software tester) تیمەکە، نوێترین main کلۆن دەکات و داواکارییەک تاقی دەکاتەوە بەو شێوەیەی سۆران دەینووسێت — بە پیتێکی گەورە:

Instead of a message in a chat that gets lost, she opens an issue on GitHub. Every issue gets a number (#12) and a page where people discuss it. A good bug report lets anyone repeat the problem: the version, the steps, what you expected and what actually happened. Labels (bug, enhancement), an assignee (who works on it) and a milestone (for example version 1.0.0) keep a long list in order. Issues hold feature ideas and tasks too, and @Shilan in a comment tells her to look.

لەبری پەیامێک لە چاتدا کە ون دەبێت، ئیشوویەک لە GitHub دەکاتەوە. هەر ئیشوویەک ژمارەیەک ⁦(#12)⁩ و پەڕەیەک وەردەگرێت کە خەڵک تێیدا گفتوگۆی لەسەر دەکەن. ڕاپۆرتێکی باشی باگ ڕێگە دەدات هەر کەسێک کێشەکە دووپاتە بکاتەوە: وەشان (Version)، هەنگاوەکان، ئەوەی چاوەڕێت دەکرد و ئەوەی بەڕاستی ڕوویدا. نیشانەکان (bug، enhancement)، کەسی بەرپرس (کێ کاری لەسەر دەکات) و قۆناغ (بۆ نموونە وەشانی ⁦1.0.0⁩) لیستێکی درێژ ڕێک دەخەن. ئیشووەکان بیرۆکەی تایبەتمەندیی نوێ و ئەرکیش هەڵدەگرن و @Shilan لە سەرنجێکدا ئاگاداری دەکاتەوە کە سەیری بکات.

Shilan takes issue #12. She never works on main directly: she pulls, starts a feature branch, makes the fix (lower-case the product name) and updates the README example. The first plain git push fails because the new branch has no upstream yet; Git itself prints the right command:

شیلان ئیشووی ⁦#12⁩ وەردەگرێت. هەرگیز ڕاستەوخۆ لەسەر main کار ناکات: پوڵ دەکات، لقێکی تایبەتمەندی دەست پێدەکات، چاکسازییەکە دەکات (ناوی کاڵاکە دەکات بە پیتی بچووک) و نموونەکەی README نوێ دەکاتەوە. یەکەم git pushـی ئاسایی سەرناکەوێت چونکە لقە نوێیەکە هێشتا upstreamـی نییە؛ Git خۆی فەرمانە دروستەکە چاپ دەکات:

On GitHub a yellow bar now offers Compare & pull request. A pull request (PR) is a page that asks: please merge my branch into yours. It names two branches — the base (where the work should go, main) and the compare branch (Shilan's) — and has four tabs: Conversation (description, comments, reviews), Commits, Checks (automatic tests, next chapter) and Files changed (the diff). Shilan writes what she changed and why, and adds Closes #12.

ئێستا لە GitHub شریتێکی زەرد ⁦Compare & pull request⁩ پێشکەش دەکات. داواکاریی بەیەککردن ⁦(PR)⁩ پەڕەیەکە کە دەپرسێت: تکایە لقەکەم لەگەڵ هی خۆت بەیەک بکە. دوو لق ناو دەبات — base (کارەکە دەبێت بچێتە کوێ، main) و لقی compare (هی شیلان) — و چوار تابی هەیە: Conversation (وەسف، سەرنج، پێداچوونەوەی کۆد)، Commits، Checks (تاقیکردنەوە خۆکارەکان (Automated testing)، بەشی داهاتوو) و Files changed (دیف). شیلان دەنووسێت چی گۆڕیوە و بۆچی و ⁦Closes #12⁩ زیاد دەکات.

Closes #12 is a closing keyword. GitHub understands close, closes, closed, fix, fixes, fixed, resolve, resolves and resolved, and closes the issue automatically when the PR is merged — but only when the PR targets the default branch (here main). Merged into any other branch, nothing is closed.

⁦Closes #12⁩ وشەی کلیلەیی داخستنـە. GitHub ئەم وشانە تێدەگات: close، closes، closed، fix، fixes، fixed، resolve، resolves و resolved و کاتێک PRـەکە بەیەک دەکرێت ئیشووەکە خۆکارانە دادەخات — بەڵام تەنیا کاتێک PRـەکە ڕووی لە لقە بنەڕەتییەکە بێت (لێرەدا main). ئەگەر لەگەڵ هەر لقێکی تر بەیەک بکرێت، هیچ شتێک داناخرێت.

Karwan reviews the PR on the Files changed tab. Code review is reading a teammate's change before it is merged, to catch problems and to share knowledge. Google's public review guide lists what to look for; in short:

کاروان لە تابی Files changed پێداچوونەوەی کۆد بۆ PRـەکە دەکات. پێداچوونەوەی کۆد خوێندنەوەی گۆڕانکاریی هاوکارێکە پێش ئەوەی بەیەک بکرێت، بۆ گرتنی کێشەکان و بۆ هاوبەشکردنی زانیاری. ڕێبەری گشتیی Google بۆ پێداچوونەوەی کۆد دەڵێت سەیری چی بکەیت؛ بە کورتی:

Comments go on single lines of the diff. Be kind and specific, explain why, and mark small wishes with Nit: so they do not block. At the end the reviewer chooses Comment, Approve or Request changes; new commits pushed to the branch appear in the PR automatically.

سەرنجەکان لەسەر تاکە دێڕەکانی دیف (Diff) دادەنرێن. میهرەبان و ورد بە، بۆچییەکەی ڕوون بکەرەوە و ئارەزووە بچووکەکان بە Nit: نیشان بکە بۆ ئەوەی ڕێگر نەبن. لە کۆتاییدا پێداچووەرەوە Comment، Approve یان Request changes هەڵدەبژێرێت؛ ئەو کۆمیتانەی دواتر پوش دەکرێنە سەر لقەکە خۆکارانە لە PRـەکەدا دەردەکەون.

The whole loop has a name: GitHub flow. GitHub's guide gives six steps, and the team follows them for every change, small or large:

هەموو ئەم سووڕە ناوێکی هەیە: GitHub flow. ڕێبەرەکەی GitHub شەش هەنگاو دەدات و تیمەکە بۆ هەموو گۆڕانکارییەک، بچووک بێت یان گەورە، پەیڕەویان دەکات:

On GitHub the green Merge pull request button makes a merge commit on main. In our stand-in Karwan, who approved the PR, does the same by hand, and then Shilan tidies up — her local branch with git branch -d, the remote one with git push origin --delete:

لە GitHub دوگمە سەوزەکەی Merge pull request کۆمیتێکی بەیەککردن لەسەر main دروست دەکات. لە جێگرەوەکەماندا کاروان، کە PRـەکەی پەسەند کرد، هەمان کار بە دەست دەکات و پاشان شیلان پاکی دەکاتەوە — لقە ناوخۆییەکەی بە git branch -d و هی کۆگای کۆدی دوور بە git push origin --delete:

Rebin is not in the team, but he wants to help. He cannot push to the team's repository, so he presses Fork: GitHub makes his own copy under his account. He clones his fork (that is his origin) and adds the team's repository as a second remote, usually called upstream, to stay up to date. When his change is ready he opens a pull request from his fork to the original. This fork and pull model is how most open-source projects accept help; teams like Bazaar Cart use the shared repository model, with branches in one repository. How a fork differs from a riff, a remix and a spin-off is explained in Riff: Building on an Idea.

ڕێبین لە تیمەکەدا نییە، بەڵام دەیەوێت یارمەتی بدات. ناتوانێت پوش بۆ کۆگای کۆدی تیمەکە بکات، بۆیە Fork دادەگرێت: GitHub کۆپییەکی تایبەت بە خۆی لە ژێر هەژماری بەکارهێنەرەکەی دروست دەکات. فۆرکەکەی خۆی کلۆن دەکات (ئەوە originـەکەیەتی) و کۆگای کۆدی تیمەکە وەک کۆگایەکی کۆدی دووری دووەم زیاد دەکات، زۆرجار بە ناوی upstream، بۆ ئەوەی نوێ بمێنێتەوە. کاتێک گۆڕانکارییەکەی ئامادە بوو، داواکارییەکی بەیەککردن لە فۆرکەکەیەوە بۆ ڕەسەنەکە دەکاتەوە. ئەم مۆدێلی fork و pullـە ڕێگەی زۆربەی پڕۆژەکانی کۆدکراوەیە (Open source) بۆ وەرگرتنی یارمەتی؛ تیمێکی وەک Bazaar Cart مۆدێلی کۆگای کۆدی هاوبەش بەکار دەهێنێت، بە چەند لقێک لە یەک کۆگای کۆددا. جیاوازیی فۆرکێک لەگەڵ riff، remix و spin-off لە Riff: بنیاتنان لەسەر بیرۆکەیەک ڕوون کراوەتەوە.

A rule can stop mistakes before they reach main. In the repository settings an owner adds branch protection (or a newer ruleset) for main. Common rules: require a pull request with at least one approval, require status checks to pass — the automatic tests of the next lesson's CI — require conversations to be resolved, and block force pushes and deletion. Then nobody, not even Aram, can push straight to main: every change arrives through a reviewed, green pull request.

یاسایەک دەتوانێت هەڵەکان ڕابگرێت پێش ئەوەی بگەنە main. خاوەنی کۆگای کۆدەکە لە ڕێکخستنەکاندا پاراستنی لق (یان rulesetـێکی نوێتر) بۆ main زیاد دەکات. یاسا باوەکان: داواکردنی داواکارییەکی بەیەککردن بە لانیکەم یەک پەسەندکردن، داواکردنی سەرکەوتنی پشکنینی دۆخ — تاقیکردنەوە خۆکارەکانی CIـی وانەی داهاتوو — داواکردنی چارەسەرکردنی گفتوگۆکان و ڕێگرتن لە force push و سڕینەوە. ئیتر هیچ کەس، تەنانەت ئارامیش، ناتوانێت ڕاستەوخۆ پوش بۆ main بکات: هەموو گۆڕانکارییەک لە ڕێی داواکارییەکی بەیەککردنی پێداچوونەوە بۆکراو و سەوزەوە دێت.

Two more GitHub tools you will meet. GitHub Pages publishes a static website straight from a repository; it is explained step by step in Publishing your website. The GitHub CLI, gh, does GitHub's web-page jobs from the terminal. The commands below are labelled examples checked against GitHub's manual, not run here (they need an account and gh auth login):

دوو ئامرازی تری GitHub کە پێیان دەگەیت. GitHub Pages تۆڕگەیەکی جێگیر ڕاستەوخۆ لە کۆگایەکی کۆدەوە بڵاو دەکاتەوە؛ هەنگاو بە هەنگاو لە بڵاوکردنەوەی تۆڕگەکەت ڕوون کراوەتەوە. GitHub CLI، gh، کارەکانی پەڕە وێبییەکانی GitHub لە تێرمیناڵەوە دەکات. ئەم فەرمانانەی خوارەوە نموونەی ناونووسکراون کە لەگەڵ ڕێنمایی GitHub بەراورد کراون، لێرە جێبەجێ نەکراون (پێویستیان بە هەژماری بەکارهێنەر و gh auth login هەیە):

A public repository can be read and copied by anyone in the world; a private one only by the people you invite. Bazaar Cart is private: it belongs to Soran's shop. Never put real customers' names or phone numbers in any repository — use made-up test data.

کۆگایەکی کۆدی گشتی هەر کەسێک لە جیهاندا دەتوانێت بیخوێنێتەوە و کۆپیی بکات؛ کۆگایەکی کۆدی تایبەت تەنیا ئەو کەسانەی بانگهێشتیان دەکەیت. Bazaar Cart تایبەتە: هی دوکانەکەی سۆرانە. هەرگیز ناو یان ژمارەی تەلەفۆنی کڕیاری ڕاستەقینە مەخەرە ناو هیچ کۆگایەکی کۆد — دراوەی (Data) تاقیکردنەوەی دروستکراو بەکار بهێنە.

Now the worst case. Karwan commits an SMS API key by mistake and pushes. In the next commit he deletes the line — but the key is still in the history: anyone with a clone can run git log -p and read it, and forks and old clones keep it too. GitHub's advice is clear: first revoke the key (make it useless) and create a new one; only then clean the history. This is why .env belongs in .gitignore from the first day.

ئێستا خراپترین حاڵەت. کاروان بە هەڵە کلیلێکی API (API key) بۆ ناردنی SMS کۆمیت و پوش دەکات. لە کۆمیتی دواتردا دێڕەکە دەسڕێتەوە — بەڵام کلیلەکە هێشتا لە مێژووـدایە: هەر کەسێک کلۆنێکی هەبێت دەتوانێت git log -p جێبەجێ بکات و بیخوێنێتەوە و فۆرکەکان و کلۆنە کۆنەکانیش هەڵی دەگرن. ئامۆژگارییەکەی GitHub ڕوونە: سەرەتا کلیلەکە هەڵبوەشێنەوە (بێسوودی بکە) و یەکێکی نوێ دروست بکە؛ تەنیا دوای ئەوە مێژووەکە پاک بکەرەوە. لەبەر ئەمەیە .env لە ڕۆژی یەکەمەوە دەچێتە ناو .gitignore.

One more, from our stand-in. A bare repository made without -b main may keep HEAD pointing at master. Push main to it and clone it, and the clone has no files:

یەکێکی تر، لە جێگرەوەکەمانەوە. کۆگایەکی کۆدی ڕووت کە بەبێ -b main دروست کرابێت لەوانەیە HEADـی ئاماژە بە master بکات. mainـی بۆ پوش بکە و کلۆنی بکە، کلۆنەکە هیچ فایلێکی تێدا نابێت:

The fix: make bare repositories with git init --bare -b main. (Real hosting services set the default branch for you.)

چاکسازی: کۆگاکانی کۆدی ڕووت بە git init --bare -b main دروست بکە. (خزمەتگوزارییە ڕاستەقینەکانی هەڵگرتنی کۆد لقە بنەڕەتییەکە بۆ تۆ دیاری دەکەن.)

Next: the version numbers on those releases — Versions and builds — and the automatic checks that turn a pull request green — Automated testing.

داهاتوو: ژمارەی وەشانەکان و وەشانە بڵاوکراوەکان (Release) — وەشان و بیلد — و ئەو پشکنینە خۆکارانەی داواکارییەکی بەیەککردن سەوز دەکەن — تاقیکردنەوەی خۆکار.