სანამ დაიწყებთ კონკრეტული თავის თარგმნას გთხოვთ გახსნათ შესაბამისი issue - ეს მნიშვნელოვანია რადგან ყველამ უნდა იცოდეს რომ თქვენ უკვე მუშაობთ და იგივე ნაწილზე სხვამაც არ დაიწყოს მუშაობა. Issue - ები შეგიძლიათ დაასათაუროთ ქართულად და სათაურში მოკლედ, ხოლო შემდეგ აღწერაში შედარებით განავრცოთ რომელი თავის თარგმნას ან რა ნაწილის ცვლილებას გეგმავთ. ცვლილებაში იგულისხმება ყველა ტიპის ცვლილება, მათ შორის მცირედი სინტაქსური ან გრამატიკული შეცდომებიც კი.
- თუ უკვე არ გაქვთ და-fork-ეთ ეს რეპოზიტორია თქვენს ექაუნთზე. (ზედა მარჯვენა კუთხეში არსებული Fork ღილაკის მეშვეობით).
- თქვენი ექაუნთის ქვეშ შექმნილი რეპოზიტორიის ასლი დაკლონეთ ლოკალურად
git clone .... - შექმენით ახალი ბრენჩი და მის სახელში გამოიყენეთ თქვენს მიერ შექმნილი issue - ს ID. (მაგალითად თუ issue - ს id არის 2 მაშინ ბრენჩის სახელი უნდა გამოიყურებოდეს ასე
2-{ბრენჩის-მოკლე-სახელი}. უფრო კონკრეტულად კი თუ თქვენ ახალ თავს ამატებთ სათაურით "ტრადიციული ვებ აპლიკაციები" მაშინ ბრენჩის სახელი შეიძლება იყოს ასეთი2-traditional-web-apps. - web ფოლდერში დაამატეთ .md ფაილი. მაგალითად
traditional-web-apps.mdდა ამ ფაილში შეგიძლიათ შეინახოთ თქვენი ქვე-თავის კონტენტი. - დაამატეთ (git add ...) და დააკომიტეთ თქვენი ცვლილებები. გაითვალისწინეთ რომ ყველა commit მესიჯს უნდა ჰქონდეს თქვენს მიერ შექმნილი issue - ს id და მიმართული უნდა იყოს ორიგინალ რეპოზიტორიაზე, ასე მაგალითად:
git commit -m "bitcamp-ge/start.bitcamp.ge#2 - adding new chapter about traditional web apps." - დაფუშეთ თქვენი ცვლილებები
git push .... - გახსენით ახალი Pull Request: თუ თქვენი ექაუნთის ქვეშ არსებულ რეპოზიტორიაში შეხვალთ, დაინახავთ ყვითელ შენიშვნას თქვენს მიერ შექმნილი ახალი ბრენჩის შესახებ, ისევე როგორც ქვემოთ მოცემულ სქრინზეა:
დააჭირეთ მწვანე ღილაკს Compare & Pull Request და აღმოჩნდებით Pull Request - ის შესაქმნელ ფორმაზე, იხ. სქრინშოთი:
დარწმუნდით რომ ისრის მარცხენა მხარეს არჩეულია bitcamp-ge/start.bitcamp.ge რეპოზიტორია და base: master ბრენჩი ხოლო მარჯვენა მხარეს თქვენი რეპოზიტორია და თქვენი ახლად შექმნილი ბრენჩი, ზუსტად ისე როგორც სურათზეა ნაჩვენები. - დააჭირეთ Create pull request მწვანე ღილაკს
- თქვენს კონტენტში სურათების დასამატებლად სურათი უნდა ჩააგდოთ
.gitbook/assets/ფოლდერში და შემდეგ დაამატოთ თქვენს დოკუმენტში markdown სინტაქსით. ასე მაგალითად. - სხვა ტიპის ელემენტებისთვის და ფორმატირების იარაღებისთვის გადახედეთ სინტაქსის დოკუმენტაციას.