Confluence-сіз команда құжаттамасы: Plane-дегі Pages және Wiki

Тапсырмалар Plane-де жүрсе, команда құжаттамасын Confluence-сіз жүргізуге болады: онда жобалардың ішінде Pages және жұмыс кеңістігі деңгейінде Wiki бар, құжаттар тапсырмалармен байланысады, ал бөлек лицензия керек емес. 2026 жылғы қазандағы жағдай бойынша Confluence Standard бір пайдаланушыға айына $5,42 тұрады, ал 100 адамға дейінгі команда үшін үш адам жүргізетін вики үшін бұл ақшаны көбіне қимайды. Бірақ құжаттар мыңдаған болып, оларды тек әзірлеушілер ғана пайдаланбайтын жерде Confluence әлі де жақсы.

Мақала команданың білімін қайда сақтау керегін таңдап жүрген тимлидтерге, IT-бөлім басшыларына және продакт-менеджерлерге арналған. Төменде: тәсілдерді салыстыру, нақты нені және қайда сақтау керек, құжаттардың иесі кім, құжатты тапсырмамен қалай байланыстыру, Confluence-те қашан қалу керек және пайдалыны жоғалтпай қалай көшу керек.

Құжаттама неге шашырап кетеді

Әдеттегі IT-командада білім бес жерде жатады: бір бөлігі Confluence немесе Notion-да, бір бөлігі Google Docs-та, бір бөлігі репозиторийлердің README файлдарында, бір бөлігі чаттардағы бекітілген хабарламаларда, ал үлкен бөлігі адамдардың басында. Жаңа қызметкер әріптестерінен сұрайды, әріптестер жеке хатта жауап береді, цикл қайталанады.

Себеп құрал таңдауда емес, екі нәрседе. Біріншісі: құжат жұмыстан бөлінген. Шешімді жазып қою үшін басқа жүйені ашып, керек бөлімді тауып, ондағы құқықтар қалай құрылғанын есіне түсіру керек. Екіншісі: құжаттың иесі жоқ. Ешкім жаңартуға міндетті емес бет бір тоқсанда ескіреді.

Сирек айтылатын үшінші себеп те бар: құжаттаманы «кейін» жазады. Алдымен тапсырма, содан кейін релиз, содан кейін келесі тапсырма, ал шешімнің сипаттамасына енді ешкім оралмайды. Бір жылдан кейін команда не істегенін есінде сақтайды, бірақ неге істегенін ұмытады, ал әрбір өзгеріс ескі чаттарды қазудан басталады.

Трекерге кірістірілген құжаттама бірінші және үшінші проблемаларды шешеді: құжат пен тапсырма бір интерфейсте, олардың арасындағы сілтеме бір рет басумен қойылады, ал бет ол туралы әлі есте тұрғанда жасалады. Екінші проблеманы тек ережелер шешеді.

Confluence әлде Plane-дегі Pages және Wiki: салыстыру

Критерий	Confluence Standard	Plane-дегі Pages және Wiki
Құны	Бір пайдаланушыға айына $5,42, Jira-дан бөлек (2026 жылғы қазан)	Plane тарифтеріне кіреді; тарифтер бойынша функциялар құрамын plane.so/pricing сайтынан қараңыз
Қайда орналасады	Atlassian-ның бөлек өнімі	Трекердің ішінде: Pages жобада, Wiki кеңістікте
Тапсырмалармен байланыс	Jira-мен интеграция	Құжат тапсырмаға байланыстырылады, тапсырмалар мәтіннен жасалады
Іздеу	Jira-дан бөлек	Тапсырмалар мен құжаттар үшін бір интерфейс
Ауқым	Мыңдаған бет, күрделі иерархиялар	100 адамға дейінгі командаларға жақсы
Қолжетімділік құқықтары	Кеңістіктер мен беттерге құқықтардың жетілген моделі	Кеңістік пен жоба рөлдері, жоғары тарифтерде Granular Access Control
Экожүйе	Үлгілер, макростар, Marketplace қосымшалары	Өсіп келеді, Plane Marketplace 2025 жылы іске қосылды
Қазақстанда сақтау	Жоқ, ҚР-да Atlassian аймақтары жоқ	Иә, self-hosted орнатуда
AI	Rovo, бөлек тарифтер	Plane-нің AI-функциялары, оның ішінде self-hosted-та
Кім пайдаланады	Бүкіл компания, техникалық емес бөлімдерді қоса	Ең алдымен трекерде жұмыс істейтін командалар

Тек ақшаны есептесеңіз, айырмашылық байқалады. 2026 жылғы қазандағы бағалар бойынша жылдық төлемде Confluence Standard 25 адамдық команда үшін жылына шамамен $1 626, 50 адам үшін шамамен $3 252 тұрады. Бірақ мұнда ақша басты дәлел емес. Бастысы — құжат пайда болып, өзекті күйде қалуы үшін қанша күш керек.

Нені қайда сақтау керек: құжаттар картасы

Құжаттаманы кез келген баптауды біз әр құжат түрінің орны мен иесі бар кестеден бастаймыз. Бұл кестесіз вики қоймаға айналады.

Құжат түрі	Қайда орналасады	Иесі	Қашан жаңарту керек
Фичаға техникалық тапсырма	Жоба Pages беттері, модульмен немесе эпикпен байланысқан	Продакт-менеджер	Әзірлеу басталғанға дейін және талаптар өзгергенде
Кездесу хаттамалары	Жоба Pages беттері	Кездесуді жүргізген адам	Кездесу күні
Ретроспективалар	Жоба Pages беттері	Тимлид	Әр циклдан кейін
Архитектуралық шешімдер (ADR)	Жоба Pages беттері немесе репозиторий	Сәулетші немесе тимлид	Әрбір маңызды шешімде
Команда регламенттері	Кеңістік Wiki-і	Әзірлеу басшысы	Тоқсанына бір рет
Онбординг	Кеңістік Wiki-і	Тимлид немесе HR	Әр жаңа қызметкер келгенде, оның кері байланысы бойынша
Кезекшілерге нұсқаулықтар	Кеңістік Wiki-і	Пайдалануға жауапты адам	Әр инциденттен кейін
API сипаттамасы, README	Репозиторий	Код авторы	Кодпен бірге
Шығарылым туралы жазбалар	Жоба Pages беттері, релизбен байланысқан	Тимлид	Релиз күні
Құпиясөздер мен кілттер	Құпиялар менеджері, вики емес	Қауіпсіздікке жауапты адам	Ротация кезінде

Даулы жағдайларға арналған ереже: құжат кодпен бірге өзгерсе, оның орны репозиторийде. Құжатты кодқа қолжетімділігі жоқ адамдар оқыса, оның орны викиде.

Құжат пен тапсырманың байланысы

Кірістірілген құжаттаманың ең құнды бөлігі — екі жақты байланыс. Тапсырмадан оның қай техникалық тапсырмаға негізделгені көрінеді. Техникалық тапсырмадан ол бойынша қандай тапсырмалар жасалғаны және олардың қандай мәртебеде екені көрінеді.

Іс жүзінде бұл қалай пайдаланылады:

• Кездесу хаттамасы. Шешімдер бетке жазылады, әр шешімнен бірден жауаптысы бар тапсырма жасалады. Бір аптадан кейін хаттама бойынша не істелгені көрінеді.
• Фичаға техникалық тапсырма. Бет модульге байланыстырылған. Продакт-менеджер талапты өзгертіп, байланысқан тапсырмаларда түсініктеме қалдырады.
• Ретро. Ретродағы жақсартулар келесі циклдың тапсырмаларына айналады. Жарты жылдан кейін ретро беттері бойынша қандай проблемалар қайталанатыны көрінеді.
• ADR. Архитектура туралы шешім ол іске асырылған тапсырмаға және оның қабылдануына себеп болған тапсырмаға сілтеме жасайды.

Jira-мен бірге Confluence-те де бұл мүмкін, бірақ екі өнімнің интеграциясы арқылы. Plane-де бұл бір интерфейстің ішіндегі бір әрекет, сондықтан команда оны жиірек жасайды.

Бастауға тұрарлық үлгілер

Бос бет — құжаттаманың басты жауы. Командада үлгі болса, хаттама бес минутта жазылады, үлгісіз оны мүлдем жазбайды. Күнделікті жұмыстың үлкен бөлігін жабу үшін төрт үлгі жеткілікті.

Фичаға техникалық тапсырма. Пайдаланушының проблемасы, мақсат және оған жеткенімізді қалай түсінеміз. Пайдалану сценарийлері. Көлемге не кіреді және не кірмейді. Макеттер немесе оларға сілтемелер. Ашық сұрақтар және оларға кім жауап береді. Байланысқан модуль немесе эпик.

Кездесу хаттамасы. Күні және қатысушылар. Күн тәртібі. Қабылданған шешімдер, әрқайсысы бөлек жолмен. Қорытындысы бойынша жасалған тапсырмалар, сілтемелерімен. Қатысушылардан не күтеміз және қай мерзімге дейін.

Ретроспектива. Не шықты. Не кедергі болды. Келесі циклда нені өзгертеміз, әр тармақ — жауаптысы бар тапсырма. Өткен ретродағы жақсартулардың мәртебесі.

Архитектуралық шешім (ADR). Контекст: қандай проблема және қандай шектеулер. Қарастырылған нұсқалар. Қабылданған шешім және себептері. Салдары: не оңайырақ, не қиынырақ болады. Мәртебесі: ұсынылды, қабылданды, басқа шешіммен ауыстырылды.

Үлгілерді тоқсанына бір рет қайта қарап шыққан жөн. Үлгінің қандай да бір бөлімі үнемі бос қалса, команданы оны толтыруға мәжбүрлемей, оны алып тастау керек.

Викидің өміршең болуына қажет ережелер

1. Викидің әр бөлімінің иесі бар, оның аты беттің басында жазылған.
2. Регламент беттерінде соңғы тексеру күні бар.
3. Техникалық тапсырма, хаттама, ретро және ADR үлгілері команда жаза бастағанға дейін жасалған.
4. Чаттарда қабылданған шешімдер сол күні бетке көшіріледі.
5. Ескірген беттер жойылмайды, белгімен мұрағатқа ауыстырылады.
6. Тоқсанына бір рет бөлімдердің иелері өз беттерін тексереді.
7. Жаңадан келген қызметкер алғашқы аптада онбордингте неге жетпегенін белгілейді, бұл тапсырмаға айналады.

Confluence қашан ең жақсы таңдау болып қалады

Confluence-тен бас тарту әрдайым ақталмайды. Мына жағдайларда онда қалуға кеңес береміз:

• Білім базасын трекерде жұмыс істемейтін сату, қолдау, HR және заңгерлер пайдаланады.
• Құжаттар мыңдаған, ал құқықтар құрылымы компанияның ұйымдық құрылымын қайталайды.
• Компания Jira Service Management пайдаланады және Confluence негізінде клиенттерге арналған білім базасын құрады.
• Маңызды процестер үлгілерге, макростарға және Marketplace қосымшаларына байланған.
• Көшуді жүргізіп, құрылымда тәртіп орнататын адам жоқ.

Гибридті нұсқа да жұмыс істейді. Жалпы корпоративтік білім базасы Confluence-те немесе бүкіл компанияға арналған басқа викиде қалады, ал әзірлеу командаларының жұмыс құжаттамасы, яғни техникалық тапсырмалар, хаттамалар, ретро және ADR, тапсырмалардың жанына Plane-ге көшеді. Бастысы — нені қайда сақтайтынын анық жазып қою, әйтпесе гибрид бір қойманың орнына екі қоймаға айналады.

Тек викиді емес, трекерді толығымен таңдап жатсаңыз, біздің Plane мен Jira салыстыруымызды қараңыз: онда құжаттама иелік етудің жалпы құнының бөлігі ретінде талданған.

Пайдалыны жоғалтпай Confluence-тен қалай көшу керек

Plane-нің штаттық импорттаушысы Jira-дағы тапсырмаларға есептелген. Confluence беттері үшін Plane нұсқаңыз көшірудің қандай нұсқаларын қолдайтынын тексеріңіз; кез келген жағдайда бәрін қатарынан көшіруге кеңес бермейміз. Біздің тәжірибемізше, жетілген Confluence-тегі беттердің үлкен бөлігін әлдеқашан ешкім ашпаған.

Көшу реті:

1. Беттер тізімін жүктеп алып, соңғы жарты жылда ашылғандарын белгілеңіз.
2. Әр тірі бөлімге иесін тағайындаңыз.
3. Тірі құжаттарды құжаттар картасы бойынша Pages пен Wiki-ге көшіріп, жолай оларды жаңартыңыз.
4. Қалғанын тек оқуға қолжетімді мұрағатқа экспортпен сақтаңыз.
5. Одан кейін Confluence-те жаңа беттер жасалмайтын күнді белгілеңіз.
6. Бір айдан кейін қандай мұрағат құжаттарына жүгінгенін тексеріп, оларды көшіріңіз.

Сілтемелерді бөлек ойластырыңыз. Тапсырмаларда, коммиттерде және чаттарда жылдар бойы Confluence беттеріне сілтемелер жиналды, көшкеннен кейін олар мұрағатқа апарады. Ең жиі пайдаланылатын беттер үшін мұрағатта жаңа орынға сілтемесі бар қысқа белгі қалдырыңыз, ал команда регламентінде жаңа сілтемелер тек Pages пен Wiki-ге қойылатынын жазыңыз.

Құжаттаманы көшірудің өзін команда Plane-дегі тапсырмаларды меңгергеннен кейін жасаған дұрыс. Трекерді енгізу реттілігін компанияда таск-трекерді енгізу туралы мақалада сипаттадық.

Қазақстан контексі. Команда құжаттамасында көбіне дербес деректер болады: онбордингтегі байланыстар, техникалық тапсырмалардағы клиенттер деректері, кадрлық регламенттердегі қызметкерлер туралы мәліметтер. Atlassian Cloud сақтау аймақтарының тізімінде Қазақстан жоқ. Компанияға мұндай деректерді елде сақтау маңызды болса, қазақстандық хостердің серверіндегі self-hosted Plane мәселені шешеді және шарт бойынша теңгеде төленеді, ал Confluence жергілікті жабу құжаттарынсыз долларда картамен төленеді. Екі тілді командалар үшін регламенттер қай тілде жүргізілетінін және қай жерде қазақша нұсқа керек екенін алдын ала шешіңіз.

Біз мұны қалай жасаймыз

Диагностикада біз команданың құжаттар картасын жасаймыз: қазір не қайда жатыр, оны кім оқиды және кім жаңартады. Содан кейін бір командамен пилот іске қосамыз: Pages пен Wiki-ді, үлгілерді және бөлімдердің иелерін баптаймыз, екі-үш аптадан кейін құжаттар жазылып жатыр ма және олар табыла ма, соны қараймыз. Пилоттан кейін қалған командалардың тірі құжаттарын көшіріп, ескі викиді жазуға жабамыз.

Тәсіл туралы толығырақ Jira және Plane таск-трекерлерін енгізу қызметі бетінде.

---

Дереккөздер. Confluence және Jira бағалары: Atlassian баға тізімі. Atlassian Cloud деректерін сақтау аймақтары: Atlassian-ның data residency туралы құжаттамасы. Plane тарифтері: plane.so/pricing. Бағалар 2026 жылғы қазандағы жылдық төлем бойынша көрсетілген және өзгеруі мүмкін.

Терминдер қарапайым тілмен

Confluence

Atlassian компаниясының құжаттамаға арналған вики-жүйесі, әдетте Jira-мен бірге жұмыс істейді. Бөлек, әр пайдаланушы үшін ай сайын төленеді.

Plane

Өз серверіңізге орнатуға болатын, бастапқы коды ашық тапсырмалар трекері. Онда тапсырмалармен байланысты құжаттарға арналған кірістірілген беттер бар.

Plane-дегі Pages және Wiki

Pages — жоба ішіндегі беттер: техникалық тапсырмалар, хаттамалар, ретро. Wiki — барлық командаларға ортақ бөлім: регламенттер, онбординг, ережелер.

Онбординг

Жаңа қызметкерді жұмысқа енгізу: нұсқаулықтар, қолжетімділіктер, команда ережелері. Викидегі жақсы онбординг әріптестерді бір сұрақтарға қайта-қайта жауап беруден құтқарады.

Ретроспектива (ретро)

Жұмыс циклынан кейінгі команда кездесуі: не шықты, не кедергі болды, нені өзгертеміз. Ретродағы жақсартуларды бірден тапсырмаларға айналдырған жөн.

ADR (Architecture Decision Record)

Архитектуралық шешім туралы қысқа жазба: қандай проблема болды, қандай нұсқалар қарастырылды және неге осы таңдалды. Бір жылдан кейін жүйенің неге дәл осылай құрылғанын түсіндіреді.

README

Кодтың репозиторийінде тұратын жоба сипаттамасы бар файл: қалай жинау, іске қосу, немен пайдалану. Кодпен бірге жаңартылады.

Self-hosted

Бағдарламаны жеткізушінің бұлтына емес, өз серверіңізге орнату. Дербес деректері бар құжаттарды Қазақстанда сақтауға мүмкіндік береді.