Versiyalarni boshqarish

Cirth hujjatlarning bir nechta versiyalarini qo'llab-quvvatlaydi, bu turli xil relizlarga ega dasturiy ta'minotlar uchun juda mos keladi. O'quvchilar versiyalar orasida almashishlari mumkin, siz esa har bir versiya uchun alohida kontentni saqlab turasiz.

Nima uchun hujjatlarni versiyalash kerak?

• Bir nechta relizlarni qo'llab-quvvatlash - v1.x foydalanuvchilariga v1.x hujjatlari kerak

• Kelgusi xususiyatlarni ko'zdan kechirish - Erta foydalanuvchilar uchun Beta hujjatlar

• Eski versiyalarni arxivlash - Eski hujjatlarni kirish imkoniyatini saqlab qolish

• Chalkashlikni kamaytirish - Foydalanuvchilar o'z versiyalariga mos keladigan hujjatlarni ko'radilar

Versiyalarni yaratish

Birinchi versiyangiz

Har bir loyiha Odatiy (Default) versiyadan boshlanadi. Bu o'quvchilar birinchi bo'lib ko'radigan asosiy hujjatlaringizdir.

Yangi versiya qo'shish

1. Loyiha sozlamalari > Versiyalar (Versions) bo'limiga o'ting

2. Yangi versiya (New Version) tugmasini bosing

3. Versiya tafsilotlarini kiriting:

   • Nomi: Ko'rinadigan nomi (masalan, "v2.0", "Beta", "Meros")

4. Yaratish tugmasini bosing

Mavjud kontentni nusxalash

Versiya yaratishda siz quyidagilarni amalga oshira olasiz:

• Noldan boshlash - Yangi kontent uchun bo'sh versiya

• Mavjudidan nusxa olish - Boshqa versiya sahifalarini dublikat qilish

Versiya sozlamalari

Odatiy versiya (Default Version)

Odatiy versiya quyidagi hollarda ko'rsatiladi:

• Foydalanuvchilar versiyani ko'rsatmasdan hujjatlaringizga tashrif buyurganida

• Qidiruv tizimlari hujjatlaringizni indekslaganida

• Havolalar versiya parametrini o'z ichiga olmaganida

Odatiy versiyani o'zgartirish uchun:

1. Versiyalar tabiga o'ting

2. Har qanday versiyada Odatiy qilib belgilash (Set as Default) tugmasini bosing

Har bir versiya uchun sahifa tarixi

Har bir versiya o'zining sahifa tarixini yuritadi:

• v1 dagi o'zgarishlar v2 ga ta'sir qilmaydi

• Tiklash nuqtalari versiyaga xosdir

• Versiyalar nusxalanayotganda tarix saqlanadi

O'quvchi tajribasi

Versiya tanlagich

O'quvchilar hujjatlar sarlavhasida versiyalar ro'yxatini ko'radilar:

      

        plaintext
        
          
          
        
      
    Hujjatlar       v2.0 ▼
                 ├── v2.0 (joriy)
                 ├── v1.5
                 └── v1.0 (eski)

URL-da versiya

Versiyalarga URL parametri orqali kirish mumkin:

      

        plaintext
        
          
          
        
      
    docs.example.com/getting-started?version=v1.5

Tanlovning saqlanib qolishi

O'quvchi versiyani tanlaganda:

• Bu sahifalar bo'ylab harakatlanganda saqlanib qoladi

• Qayta tashriflar uchun brauzerda saqlanadi

Versiyalar bo'ylab kontentni boshqarish

Mustaqil sahifalar

Har bir versiya o'z sahifalar to'plamiga ega:

• Sahifa sarlavhalari versiyalar orasida farq qilishi mumkin

• Kontent versiyaga xosdir

• Sluglar umumiy (bir xil URL tuzilishi)

Umumiy modellar

Ketma-ket versiyalar (1.0 → 2.0)

1. v1.0 dan nusxa olib, v2.0 ni yarating

2. Yangi xususiyatlar uchun sahifalarni yangilang

3. Eskirgan xususiyatlarni belgilang

4. Tayyor bo'lgach, v2.0 ni odatiy qilib belgilang

Parallel versiyalar (Barqaror + Beta)

1. "Stable" (Barqaror) ni odatiy sifatida saqlang

2. Kelgusi xususiyatlar uchun "Beta" ni yarating

3. Beta tayyor bo'lgach, yangi barqaror versiyaga nusxalang

4. Eski barqaror versiyani "Legacy" (Meros) sifatida arxivlang

Eng yaxshi amaliyotlar

Nomlash qoidalari

Aniq va barqaror nomlarni tanlang:

Qachon versiya yaratish kerak

Quyidagilar uchun yangi versiyalar yarating:

• Katta o'zgarishlarga (breaking changes) ega asosiy relizlar

• Yangi API yoki xususiyatlar

• Muhim UI/UX o'zgarishlari

Quyidagilar uchun versiya yaratmang:

• Kichik xatolarni tuzatish

• Imloviy xatolarni to'g'rilash

• Kichik tushuntirishlar

Versiyalarni sinxron holatda saqlash

Versiyalar bo'ylab umumiy bo'lgan kontent uchun:

1. Umumiy sahifalarni aniqlang (masalan, "Haqida", "Qo'llab-quvvatlash")

2. Bular o'zgarganda barcha versiyalarni yangilang

3. Yagona manbaga havola berishni o'ylab ko'ring

Eskirish strategiyasi (Deprecation Strategy)

Versiyadan voz kechayotganda:

1. Barcha sahifalarga eskirish haqida bildirishnoma qo'shing

2. Joriy versiyaga havola bering

3. To'xtatish sanasini belgilang

4. Oxir-oqibat arxivlang yoki o'chiring

Versiya cheklovlari

Sizning tarif rejangizga qarab:

Sahifa tarixi va versiyalar

Tarix qanday ishlaydi

• Har bir versiyadagi har bir sahifa mustaqil tarixga ega

• Tiklash boshqa versiyalarga ta'sir qilmaydi

• Versiyani nusxalash joriy holatni nusxalaydi (tarixni emas)

Saqlashni optimallashtirish

Cirth delta-siqishdan foydalanadi:

• To'liq nusxalar emas, faqat o'zgarishlar saqlanadi

• Har 10 ta versiyada asosiy snapshotlar olinadi

• To'liq nusxalarga qaraganda saqlash hajmi ~90% ga kamayadi

Muammolarni bartaraf etish

Versiya ko'rinmayapti

• Versiyada chop etilgan sahifalar borligini tekshiring

• Versiya arxivlanmaganligiga ishonch hosil qiling

• Sahifa holati "Chop etilgan" (Published) ekanligini tasdiqlang

Noto'g'ri versiya ko'rsatilyapti

• Brauzer keshini tozalang

• URL parametrlarini tekshiring

• Odatiy versiya sozlamalari tasdiqlang

Nusxalashdan keyin kontent yetishmayapti

• Nusxalash bir zumda sodir bo'ladi - sahifani yangilang

• Sahifalar "Draft" holatida emasligini tekshiring

• Nusxalash muvaffaqiyatli yakunlanganligini tasdiqlang