Patch chapter 3

Author: Davoodeh

book/03-git-branching/sections/basic-branching-and-merging.asc

@@ -1,8 +1,8 @@
 [[_branch_management]]
-=== مدیریت برنچ
+=== مدیریت شاخه
 
 (((branches, managing)))
-حال که چند برنچ را ساخته‌اید، مرج و پاک کرده‌اید، بیاید نگاهی به چند ابزار مدیریت برنچ بیندازیم که وقتی به شروع به استفادهٔ مادام از برنچ‌ها کردید به کارتان می‌آید.
+حال که چند برنچ ساخته‌اید، مرج و پاک کرده‌اید، بیاید نگاهی به چند ابزار مدیریت برنچ بیندازیم که وقتی شروع به استفادهٔ مادام از برنچ‌ها کردید به کارتان می‌آید.
 
 دستور `git branch` بیشتر از ساختن و نابود کردن برنچ‌ها به کار می‌آید.
 اگر بدون هیچ آرگومانی آنرا اجرا کنید، یک لیست ساده از برنچ‌های حاضر پروژه را به شما نمایش می‌دهد:
@@ -15,8 +15,8 @@ $ git branch
   testing
 ----
 
-به علامت `*` که پیش از برنچ `master` آمده توجه کنید: این علامت نشان‌دهندهٔ برنچی است که چک‌اوت کرده‌اید (به بیان دیگر برنچی که `HEAD` به آن اشاره دارد).
-این بدان معناست که اگر الآن کامیتی بگیرید، برنچ `master` با کار جدید شما به جلو می‌رود.
+به علامت `*` که پیش از برنچ `master` می‌آید توجه کنید: این علامت نشان‌دهندهٔ برنچی است که چک‌اوت کرده‌اید (به بیان دیگر برنچی که `HEAD` به آن اشاره دارد).
+این بدان معناست که اگر الآن کامیتی بگیرید، برنچ `master` با کار جدید شما به جلو خواهد رفت.
 برای دیدن آخرین کامیت هر برنچ می‌توانید `git branch -v` را اجرا کنید:
 
 [source,console]
@@ -38,8 +38,7 @@ $ git branch --merged
 ----
 
 به این دلیل که شما سابقاً با `iss53` مرج شده‌اید آنرا در این لیست مشاهده می‌کنید.
-برنچ‌هایی که در این لیست در مقابلشان `*` ندارد، غالباً می‌توانند بی‌مشکل با `git branch -d` پاک شوند.
-شما قبل‌تر آنها را درون برنچی دیگر ریخته‌اید پس با پاک کردنشان چیزی از دست نخواهید داد.
+برنچ‌هایی در این لیست که مقابلشان `*` ندارد، غالباً می‌توانند بی‌مشکل با `git branch -d` پاک شوند؛ شما قبل‌تر آنها را درون برنچی دیگر ریخته‌اید پس با پاک کردنشان چیزی را از دست نخواهید داد.
 
 برای مشاهده تمام برنچ‌هایی که شامل کارهایی هستند که هنوز مرج‌شان نکرده‌اید، می‌توانید `git branch --no-merged` را اجرا کنید:
 
@@ -50,7 +49,7 @@ $ git branch --no-merged
 ----
 
 این دستور برنچ دیگر شما را نشان می‌دهد.
-به این دلیل که شامل کاری است که هنوز مرج نکرده‌اید، تلاش برای پاک کردنش با `git branch -d` شکست خواهد خورد:
+به این دلیل که شامل کاری است که هنوز مرج نکرده‌اید، تلاش برای پاک کردن آن با `git branch -d` شکست خواهد خورد:
 
 [source,console]
 ----
@@ -59,14 +58,15 @@ error: The branch 'testing' is not fully merged.
 If you are sure you want to delete it, run 'git branch -D testing'.
 ----
 
-اگر واقعاً می‌خواهیدی که آنرا پاک کنید و کار خود را از دست بدهید می‌توانید با `-D` آنرا به گیت تحمیل کنید، همانطور که در پیغام کمکی بالا به آن اشاره شده است.
+اگر واقعاً می‌خواهیدی که آنرا پاک کنید و کار خود را از دست بدهید می‌توانید با `-D` آنرا به گیت تحمیل کنید، همانطور پیغام مفید بالا به آن اشاره می‌کند.
 
 [TIP]
 ====
-اگر نام برنچ یا کامیتی به عنوان یک آرگومان به آپشن‌های مشروح بالا داده نشود، `--merged` و `--no-merged` به ترتیب به شما خروجی‌هایی را نشان می‌دهند که به نسبت برنچ _حاضر_ مرج‌شده یا مرج‌نشده‌اند.
+آپشن‌هایی که بالا توضیح داده شدند، `--merged` و `--no-merged` اگر نام برنچ یا کامیتی را به عنوان آرگومان دریافت نکنند، به شما خروجی‌هایی را نشان می‌دهند که به نسبت برنچ _حاضر_، به ترتیب،
+مرج‌شده یا مرج‌نشده‌اند.
 
-همیشه می‌توانید یک آرگومان اضافه برای درخواست وضعیت مرج حاضر به نسبت برنچی خاص را وارد دستور کنید بدون آنکه بخواهید روی آن برنچ چک‌اوت کنید،
-مثلاً بخواهید بدانید چه برنچی با برنچ `master` مرج نشده است.
+همیشه می‌توانید یک آرگومان اضافه برای درخواست وضعیت مرج به نسبت برنچی خاص را وارد دستور کنید بدون آنکه بخواهید روی آن برنچ چک‌اوت کنید،
+مثلاً چه برنچی با برنچ `master` مرج نشده است؟
 [source,console]
 ----
 $ git checkout testing

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

@@ -1,14 +1,14 @@
 [[_git_branches_overview]]
-=== برنچ‌ها در یک کلمه
+=== شاخه‌ها در یک کلمه
 
 برای اینکه به راستی نحوهٔ شاخه‌سازی گیت را درک کنید، باید یک قدم به عقب برگردیم و نحوهٔ ثبت اطلاعات گیت را مطالعه کنیم.
 
-همانطور که از <<ch01-getting-started#ch01-getting-started>> به یاد دارید،‌گیت داده‌ها را به عنوان دسته‌ای از تغییرات یا تفاوت‌هایی بین فایل‌ها ذخیره نمی‌کند؛
-بلکه اطلاعات را بر به عنوان مجموعه‌ای از _اسنپ‌شات‌ها_ ذخیره می‌کند.
+همانطور که از <<ch01-getting-started#ch01-getting-started>> به یاد دارید، ‌گیت داده‌ها را به عنوان دسته‌ای از تغییرات یا تفاوت‌هایی بین فایل‌ها ذخیره نمی‌کند؛
+بلکه اطلاعات را به عنوان مجموعه‌ای از _اسنپ‌شات‌ها_ ذخیره می‌کند.
 
 وقتی یک کامیت می‌سازید، گیت یک آبجکت کامیت که شامل یک نشانگر به اسنپ‌شات دربرگیرندهٔ اطلاعات صحنهٔ شماست را ذخیره می‌کند.
-این آبجکت همچنین شامل نام نویسنده و آدرس ایمیل او، پیغامی که وارد کرده‌اید و یک نشانگر به کامیت یا کامیت‌هایی که مستقیماً قبل این کامیت (والد یا والدین) آمده‌اند است.
-کامیت اولیه والدی ندارد؛ یک کامیت معمولی یک والد دارد؛ یک کامیت که حاصل مرج یک یا چند برنچ است چند والد دارد.
+این آبجکت همچنین شامل نام نویسنده و آدرس ایمیل او، پیغامی که وارد کرده‌اید و یک نشانگر به کامیت یا کامیت‌هایی که مستقیماً قبل این کامیت (والد یا والدین) آمده‌اند است:
+صفر والد برای کامیت اولیه، یک والد برای یک کامیت معمولی و چند والد برای یک کامیت مرج حاصل یک یا چند برنچ.
 
 برای ملموس کردن این موضوع، فرض را بر این بگذاریم که پوشه‌ای حاوی سه فایل داریم و شما همهٔ آنها را استیج و کامیت می‌کنید.
 استیج کردن فایل‌های برای هر کدام از آنها یک چک‌سام (هش SHA-1 که در<<ch01-getting-started#ch01-getting-started>> ذکر کردیم) محاسبه می‌کند، آن نسخه از فایل را در مخزن گیت ذخیره می‌کند،
@@ -41,16 +41,16 @@ image::images/commits-and-parents.png[Commits and their parents.]
 
 [NOTE]
 ====
-برنچ ``master'' در گیت برنچ خاصی نیست.(((master)))
+برنچ «master» در گیت برنچ خاصی نیست.(((master)))
 این برنچ دقیقاً مشابه هر برنچ دیگری است.
 تنها دلیلی که تقریباً همهٔ مخزن‌ها یک برنچ با این نام دارند این است که دستور `git init` به طور پیش‌فرض آنرا می‌سازد و بیشتر مردم هم زحمت تغییر این نام را به خود نمی‌دهند.
 ====
 
-.یک برنچ و تاریخچهٔ کامیت‌هایش
+.یک برنچ و تاریخچهٔ کامیت‌های آن
 image::images/branch-and-history.png[A branch and its commit history.]
 
 [[_create_new_branch]]
-==== ساختن یک برنچ جدید
+==== ساختن یک شاخه جدید
 
 (((branches, creating)))
 وقتی یک برنچ جدید می‌سازید چه اتفاقی می‌افتد؟
@@ -120,7 +120,7 @@ $ git commit -a -m 'made a change'
 .هنگامی که کامیتی ساخته می‌شود برنچ هد به جلو می‌رود
 image::images/advance-testing.png[The HEAD branch moves forward when a commit is made.]
 
-این مسئله جالب است چرا که الآن برنچ `testing` به جلو رفت در حالی که برنچ `master` هنوز به کامیتی که سابقاً، حین اجرای `git checkout` که برای تعویض برنچ‌ها استفاده شد، اشاره می‌کند.
+این جالب است چرا که الآن برنچ `testing` به جلو رفت در حالی که برنچ `master` هنوز به کامیتی، که سابقاً روی آن `git checkout` که برای تعویض برنچ‌ها استفاده شد، اشاره می‌کند.
 بیایید دوباره به برنچ `master` بازگردیم:
 
 [source,console]
@@ -137,26 +137,26 @@ $ git checkout master
 به بیان دیگر، در حالت پیش‌فرض، `git log` فقط تاریخچهٔ کامیت‌های زیر برنچی که شما چک‌اوت کرده‌اید را نمایش می‌دهد.
 
 برای نمایش تاریخچهٔ کامیت‌های برنچ مورد نظر باید به صراحت آن را نام ببرید: `git log testing`.
-برای نمایش تمام برنچ‌ها `--all` را به دستور `git log`تان بی‌افزایید.
+برای نمایش تمام برنچ‌ها `--all` را به دستور `git log` خود بی‌افزایید.
 ====
 
 .وقتی چک‌اوت می‌کنید هد جابه‌جا می‌شود
 image::images/checkout-master.png[HEAD moves when you checkout.]
 
-آن دستور دو کار اصلی انجام داد.
-نشانگر هد را بازگردان تا به برنچ `master` اشاره کند و فایل‌هایی که در پوشه کاری کاری شما بودند را به اسنپ‌شاتی که `master` به آن اشاره می‌کرد بازگردانی (Revert/ریورت) کرد.
-این مسئله همچنین به این معنا است که تغییراتی که از این نقطه به بعد اعمال کنید از نسخه‌های قدیمی‌تر پروژه جدا خواهد ماند.
+آن دستور دو کار انجام داد.
+نشانگر هد را بازگرداند تا به برنچ `master` اشاره کند و فایل‌هایی که در پوشه کاری شما بودند را به اسنپ‌شاتی که `master` به آن اشاره می‌کرد بازگردانی کرد.
+این همچنین به این معنا است که تغییراتی که از این نقطه به بعد اعمال کنید از نسخه‌های قدیمی‌تر پروژه جدا خواهد ماند.
 در ساده‌ترین تعریف، کاری که در برنچ `testing` کردید را خنثی می‌کند تا بتوانید راه دیگری را در پیش بگیرید.
 
 [NOTE]
 .تعویض برنچ فایل‌های درون پوشه کاری را تغییر می‌دهد
 ====
 بسیار مهم است که به خاطر داشته باشید که تعویض برنچ در گیت فایل‌هایی که در پوشه کاری دارید را تغییر می‌دهد.
-اگر به برنچ قدیمی‌تری انتقال پیدا کنید، پوشه کاری شما به آن صورتی بازگردانی خواهد شد که آخرین بار هنگام ایجاد کامیت بود روی آن برنچ بوده است.
-اگر گیت نتواند این بازگردانی را به صورت بی‌نقص انجام دهد، نمی‌گذارد که تعویض برنچ انجام شود.
+اگر به برنچ قدیمی‌تری انتقال پیدا کنید، پوشه کاری شما به آن صورتی بازگردانی خواهد شد که آخرین بار هنگام ایجاد کامیت روی آن برنچ بوده است.
+اگر گیت نتواند این بازگردانی را به صورت بی‌نقص انجام دهد، نمی‌گذارد تعویض برنچ انجام شود.
 ====
 
-بیایید چند تغییر جدید اعمال کنیم و دوباره کامیت بگیریم:
+بیایید چند تغییر اعمال کنیم و دوباره کامیت بگیریم:
 
 [source,console]
 ----
@@ -165,16 +165,16 @@ $ git commit -a -m 'made other changes'
 ----
 
 اکنون تاریخچه پروژه شما دوشاخه شده است (به <<divergent_history>> مراجعه کنید).
-شما یک برنچ ساختید و به آن انتقال پیدا کردید، کمی روی آن کار کردید و سپس به برنچ اصلیتان بازگشتید و کمی کار متفاوت آنجا انجام دادید.
+شما یک برنچ ساختید و به آن انتقال پیدا کردید، کمی روی آن کار کردید و سپس به برنچ اصلی خود بازگشتید و آنجا کمی کار متفاوت انجام دادید.
 هر دوی آن تغییرات به صورت ایزوله در برنچ‌های خودشان موجوداند: شما می‌توانید بین برنچ‌ها جابه‌جا شوید و هرگاه آماده بودید آنها را با هم مرج کنید.
-و جالبتر اینکه همهٔ این کارها صرفاً با دستورهای `branch`، `checkout` و `commit` انجام دادید.
+و جالبتر اینکه همهٔ این کارها را صرفاً با دستورهای `branch`، `checkout` و `commit` انجام دادید.
 
 [[divergent_history]]
 .تاریخچه دوشاخه شده
 image::images/advance-master.png[Divergent history.]
 
 علاوه بر آن، با دستور `git log` می‌توانید این اطلاعات را ببینید.
-اگر `git log --oneline --decorate --graph --all` را اجرا کنید، برنامه تاریخچهٔ کامیت‌های شما را نمایش می‌دهد، نشان می‌دهد که نشانگرهای برنچ‌هایتان کجاست و چگوننه تاریخچهٔ شما دو شاخه شده است.
+اگر `git log --oneline --decorate --graph --all` را اجرا کنید، برنامه تاریخچهٔ کامیت‌های شما را نمایش می‌دهد، نشان می‌دهد که نشانگرهای برنچ‌هایتان کجاست و چگونه تاریخچهٔ شما دو شاخه شده است.
 
 [source,console]
 ----
@@ -190,15 +190,15 @@ $ git log --oneline --decorate --graph --all
 از این جهت که برنچ در گیت صرفاً یک فایل سادهٔ محتوی یک چک‌سام SHA-1 چهل حرفی کامیتی است که به آن اشاره می‌کند، ساختن و از بین بردن برنچ‌ها کم هزینه است.
 ساختن یک برنچ جدید به سادگی و سرعت نوشتن ۴۱ بایت اطلاعات درون یک فایل است (۴۰ حرف و یک خط جدید).
 
-این قضیه بسیار متفاوت با نحوهٔ برنچ‌سازی ابزارهای VCS قدیمی است که شامل کپی کردن تمام فایل‌های پروژه به یک پوشه ثانوی می‌باشد.
+این قضیه بسیار متفاوت با نحوهٔ برنچ‌سازی بیشتر ابزارهای VCS قدیمی است که شامل کپی کردن تمام فایل‌های پروژه به یک پوشه ثانوی می‌باشد.
 این می‌تواند چندین ثانیه یا حتی دقیقه، بسته به سایز پروژه، طول بکشد؛ درحالی که در گیت این فرآیند همیشه آنی است.
-همچنین به علت اینکه هنگامی که کامیت می‌کنیم والد را هم در کامیت ثبت می‌کنیم، پیدا کردن یک پایهٔ ادغام برای مرج کردن به صورت خودکار برای ما انجام می‌شود و به طور کل به سهولت انجام می‌پذیرد.
-معمولاً مزایا توسعه‌دهندگان را به ساختن و استفاده از برنچ‌ها مشتاق می‌کند.
+همچنین به علت اینکه هنگامی که کامیت می‌کنیم والد را هم در کامیت ثبت می‌کنیم، پیدا کردن یک پایهٔ ادغام برای مرج کردن به صورت خودکار برای ما انجام می‌شود و به طور کل انجام آن بسیار آسان است.
+این مزایا توسعه‌دهندگان را به ساختن و استفاده بیشتر از برنچ‌ها مشتاق می‌کند.
 
-بیایید به اینکه چرا باید شما هم از این کار را کنید نگاهی بیاندازیم.
+بیایید به اینکه چرا شما نیز باید این کار را کنید نگاهی بیاندازیم.
 
 [NOTE]
 .ساختن یک برنچ جدید و انتقال به آن در آن واحد
 ====
-خیلی اوقات پیش می‌آید که یک برنچ جدید بسازید و در آن واحد بخواهید به آن انتقال یابید -- این کار در یک عملیات با `git checkout -b <newbranchname>` قابل انجام است.
+خیلی اوقات پیش می‌آید که یک برنچ جدید بسازید و بخواهید در آن واحد به آن انتقال یابید -- این کار در یک عملیات با `git checkout -b <newbranchname>` قابل انجام است.
 ====