❗ძირითადი კრიტერიუმები

ეს არის იმ სტანდარტების ერთობლიობა, რომლითაც ვხელმძღვანელობთ ბუთქემფში. თქვენს კოდს ყოველ pull request-ზე გადახედავს რევიუერი. თუ თქვენი კოდი იქნება სტანდარტებთან შეუსაბამო, ჩაყრის შესაბამის issue-ებს.

• გამართე prettier და Eslint, კოდი ფორმატდებოდეს დასეივებისას.

• აპლიკაციაში გამართე სწორი ფაილური სტრუქტურა.

• დაიცავი Naming კონვენციები, ცვლადებს დაარქვი ინტუიციური pascalCase სახელები.

• ტექსტის თარგმანი უნდა იყოს გაკეთებული ჩვენი სტატიის მიხედვით. Localization (i18n)

• სწორად გამოიყენე Env ცვლადები და შესაბამისად .env და .env.example ფაილები.

Style Guide

ამ სექციაში განხილულია ოფიციალური Style Guide. სასურველია მთლიანად წაკითხოთ და გაეცნოთ მას, მაგრამ აქ მაინც იქნება მოთავსებული ის მინიმალური ინფო რომელიც უნდა დაიცვათ და რომლებსაც კოუდ რევიუერები დაახარვეზებენ.

• Multi-word component names -კომპონენტებს უნდა ჰქონდეთ მინიმუმ 2 სიტყვიანი სახელები

• Use detailed prop definitions - propertie-ები უფრო დეტალურად უნდა იყოს განსაზღვრული. ყველაზე მინიმუმი არის ტიპისა და required ის განსაზღვრა.

• Use keyed v-for - სადაც არის v-for აუცილებლად უნდა იყოს :key

• Avoid v-if with v-for - არასოდეს გამოიყენო v-if v-for თან ერთად

• Component files - ერთ ფაილში უნდა იყოს მხოლოდ 1 კომპონენტი, არასოდეს მეტი

• Component File name - კომპონენტის სახელი უნდ აიყოს PascalCase.vue ან kebab-case.vue

• Tightly coupled component names - [!] აუცილებლად წაიკითხეთ და კარგად გაიაზრეთ რაც ოფიციალურ სტატიაში წერია ამის შესახებ. აუცილებლად გახსენით Detailed Explanation ის სექციაც.

• Order of words in component names - კომპონენტის სახელებად უნდა გვწერეოს ჯერ მთავარი ზოგადი სიტყვები და მერე მოდიფიკატორები

• Full-word component names - [!] არ შეამოკლო კომპონენტების სახელები, ყოველთვის გამოიყენე სრულ სიტყვები, მაგალითად skill და არა sk. ეს მარტივი მავნე ჩვევა კოდის კითხვადობას საგრძნობლად ამცირებს. ანალოგიური ეხება ცვლადის სახელებს, ფუნქციის სახელებს და ა.შ

• Simple expressions in templates - თემფლეთში არასოდეს უნდა გვეწეროს რთული ლოგიკა. თუ რამე რთული ლოგიკაა უნდა იყოს გატანილი computed ან method-ად.

• Alt Tags -ალტ ტეგებს ყოვეთვის უნდა გაუწერო შესაბამისი შინაარსობრივი მნიშვნელობები, არასოდეს გამოიყენო სიტყვები image, picture ან რაიმე მსგავსი. SEO ოპტიმიზაციისთვის არის ძალიან მნშვნელოვანი რომ ეს ჩვევა თავიდანვე გამოიმუშავო.