Chapter 3 (draft) is complete!

Author: Davoodeh

README.asc

@@ -44,6 +44,18 @@ Converting to PDF...
 
 با توجه به دشواری بازتنظیمی اسکی‌داکتر ممکن است بخواهید از خروجی اچ‌تی‌ام‌ال استفاده کرده یا در صورت نیاز به پی‌دی‌اف، خروجی اچ‌تی‌ام‌ال را توسط ابزاری مانند مرورگر به پی‌دی‌اف تبدیل کنید.
 
+=== ترجمهٔ ناقص
+
+ممکن است ترجمه‌ها پیش‌نویس یا ناقص و یا کلمات یکپارچگی نداشته باشند. این امر ممکن است به دلایل مختلف (محدودیت‌های فنی) اتفاق افتاده باشد. اگر چنین موردی مشاهده کردید و در تودو ذکر نشده بود یا برای
+آن ایشوی نظیری وجود نداشت یا آنرا حل کرده و پول ریکوئست درست کنید و یا در ایشوهای به ما یادآوری کنید تا در اسرع وقت آنرا پیگیری کنیم.
+
+به طور کل فایل‌های بالای ۸۰ درصد در فایل استاتوس.جی‌سان کامل تلقی می‌شوند.
+فایل‌های ۹۵ درصد ترجمهٔ نهایی شده‌اند و نیازمند بازبینی هستند و فایل‌های ۹۰ درصد پیش‌نویس نهایی هستند.
+
+=== لینک‌های انگلیسی یا ناقص
+
+ترجمهٔ لینک‌ها و اتصال آنها کار دشواری است. به همین دلیل این کار در مراحل آخر اصلاح خواهد شد. لطفاً شکیبا باشید.
+
 == همکاری
 
 اگر مایلید کمک کنید تا تغییری ایجاد شود، لطفاً به link:CONTRIBUTING.md[راهنمای همکاری] مراجعه کنید.

TRANSLATION_NOTES.asc

@@ -10,6 +10,9 @@
 * همچنان که متن ترجمه می‌شود، لطفاً فایل جی‌سان استاتوس را بروزرسانی کنید تا درصد احتمالی اینکه هر فایل به چه مقدار ترجمه شده است قابل تخمین باشد.
 این تخمین روی صفحات مختلف نمایش داده می‌شود تا خوانندگان بدانند چه مقدار از کار باقی مانده است.
 
+به طور کل فایل‌های بالای ۸۰ درصد در فایل استاتوس.جی‌سان کامل تلقی می‌شوند.
+فایل‌های ۹۵ درصد ترجمهٔ نهایی شده‌اند و نیازمند بازبینی هستند و فایل‌های ۹۰ درصد پیش‌نویس نهایی هستند.
+
 === استاندارد نگارشی
 
 * تلاش بر آن باشد که هرگز خطی از ۲۰۰ حرف تجاوز نکند.
@@ -56,6 +59,7 @@
 |===
 |واژه یا عبارت |معادل احتمالی انگلیسی
 
+|??? |Fast-Forward
 |کنترل نسخه |Version Control
 |ساب‌ورژن |Subversion
 |چک‌اوت |Checkout
@@ -95,4 +99,10 @@
 |تعویض برنچ |Branch switching
 |ریورت |Revert
 |ایشو |Issue
+|درپی-ریموت |Remote-Tracking
+|مرجع ریموت |Remote refrence
+|بالادست |Upstream
+|برنچ پیگیر |Tracking Branch
+|ریبیس |Rebase
+|دوشاخه |Divergent
 |===

book/03-git-branching/sections/branch-management.asc

@@ -1,11 +1,11 @@
 [[_branch_management]]
-=== Branch Management
+=== مدیریت برنچ
 
 (((branches, managing)))
-Now that you've created, merged, and deleted some branches, let's look at some branch-management tools that will come in handy when you begin using branches all the time.
+حال که چند برنچ را ساخته‌اید، مرج و پاک کرده‌اید، بیاید نگاهی به چند ابزار مدیریت برنچ بیندازیم که وقتی به شروع به استفادهٔ مادام از برنچ‌ها کردید به کارتان می‌آید.
 
-The `git branch` command does more than just create and delete branches.(((git commands, branch)))
-If you run it with no arguments, you get a simple listing of your current branches:
+دستور `git branch` بیشتر از ساختن و نابود کردن برنچ‌ها به کار می‌آید.
+اگر بدون هیچ آرگومانی آنرا اجرا کنید، یک لیست ساده از برنچ‌های حاضر پروژه را به شما نمایش می‌دهد:
 
 [source,console]
 ----
@@ -15,9 +15,9 @@ $ git branch
   testing
 ----
 
-Notice the `*` character that prefixes the `master` branch: it indicates the branch that you currently have checked out (i.e., the branch that `HEAD` points to).
-This means that if you commit at this point, the `master` branch will be moved forward with your new work.
-To see the last commit on each branch, you can run `git branch -v`:
+به علامت `*` که پیش از برنچ `master` آمده توجه کنید: این علامت نشان‌دهندهٔ برنچی است که چک‌اوت کرده‌اید (به بیان دیگر برنچی که `HEAD` به آن اشاره دارد).
+این بدان معناست که اگر الآن کامیتی بگیرید، برنچ `master` با کار جدید شما به جلو می‌رود.
+برای دیدن آخرین کامیت هر برنچ می‌توانید `git branch -v` را اجرا کنید:
 
 [source,console]
 ----
@@ -27,8 +27,8 @@ $ git branch -v
   testing 782fd34 Add scott to the author list in the readme
 ----
 
-The useful `--merged` and `--no-merged` options can filter this list to branches that you have or have not yet merged into the branch you're currently on.
-To see which branches are already merged into the branch you're on, you can run `git branch --merged`:
+آپشن‌های پرکاربرد `--merged` و `--no-merged` می‌توانند این لیست را به برنچ‌هایی که هنوز به برنچ حاضر مرج‌کرده یا نکرده‌اید محدود کند.
+برای اطلاع از اینکه چه برنچی با برنچ حاضر مرج‌شده است می‌توانید دستور `git branch --merged` را اجرا کنید:
 
 [source,console]
 ----
@@ -37,19 +37,20 @@ $ git branch --merged
 * master
 ----
 
-Because you already merged in `iss53` earlier, you see it in your list.
-Branches on this list without the `*` in front of them are generally fine to delete with `git branch -d`; you've already incorporated their work into another branch, so you're not going to lose anything.
+به این دلیل که شما سابقاً با `iss53` مرج شده‌اید آنرا در این لیست مشاهده می‌کنید.
+برنچ‌هایی که در این لیست در مقابلشان `*` ندارد، غالباً می‌توانند بی‌مشکل با `git branch -d` پاک شوند.
+شما قبل‌تر آنها را درون برنچی دیگر ریخته‌اید پس با پاک کردنشان چیزی از دست نخواهید داد.
 
-To see all the branches that contain work you haven't yet merged in, you can run `git branch --no-merged`:
+برای مشاهده تمام برنچ‌هایی که شامل کارهایی هستند که هنوز مرج‌شان نکرده‌اید، می‌توانید `git branch --no-merged` را اجرا کنید:
 
 [source,console]
 ----
 $ git branch --no-merged
   testing
 ----
 
-This shows your other branch.
-Because it contains work that isn't merged in yet, trying to delete it with `git branch -d` will fail:
+این دستور برنچ دیگر شما را نشان می‌دهد.
+به این دلیل که شامل کاری است که هنوز مرج نکرده‌اید، تلاش برای پاک کردنش با `git branch -d` شکست خواهد خورد:
 
 [source,console]
 ----
@@ -58,13 +59,14 @@ error: The branch 'testing' is not fully merged.
 If you are sure you want to delete it, run 'git branch -D testing'.
 ----
 
-If you really do want to delete the branch and lose that work, you can force it with `-D`, as the helpful message points out.
+اگر واقعاً می‌خواهیدی که آنرا پاک کنید و کار خود را از دست بدهید می‌توانید با `-D` آنرا به گیت تحمیل کنید، همانطور که در پیغام کمکی بالا به آن اشاره شده است.
 
 [TIP]
 ====
-The options described above, `--merged` and `--no-merged` will, if not given a commit or branch name as an argument, show you what is, respectively, merged or not merged into your _current_ branch.
+اگر نام برنچ یا کامیتی به عنوان یک آرگومان به آپشن‌های مشروح بالا داده نشود، `--merged` و `--no-merged` به ترتیب به شما خروجی‌هایی را نشان می‌دهند که به نسبت برنچ _حاضر_ مرج‌شده یا مرج‌نشده‌اند.
 
-You can always provide an additional argument to ask about the merge state with respect to some other branch without checking  that other branch out first, as in, what is not merged into the `master` branch?
+همیشه می‌توانید یک آرگومان اضافه برای درخواست وضعیت مرج حاضر به نسبت برنچی خاص را وارد دستور کنید بدون آنکه بخواهید روی آن برنچ چک‌اوت کنید،
+مثلاً بخواهید بدانید چه برنچی با برنچ `master` مرج نشده است.
 [source,console]
 ----
 $ git checkout testing