Өзгерістер парағын қалай жасау керек: жазбалар, тегтер, RSS және «Жаңалық не»

Өзгерістер парағы — өніміңізде не өзгергенінің күнге реттелген тізімі, ең жаңасы алдымен, оны қолданушыларға арналып жазасыз. Оны жасау үшін жазбалар керек: күні, анық тақырыбы, қысқа түсіндірмесі және тегі (New, Improved, Fixed), барлық жазбаларды тізімдейтін бет, әр жазбаның жеке URL-і, және мүмкін болса RSS арнасы мен қолданушыға жаңа бірдеңе бар екенін хабарлау тәсілі. Бұл жасауға ең қарапайым нәрселердің бірі, ал негізгі шешім — жазбалар қайда тұрады: сайттағы файлдарда ма, әлде әкімші беті бар дерекқорда ма.

Өзгерістер парағы неге керек

Өзгерістер парағы клиенттерге және әлеуетті клиенттерге өнімнің қолдау көрсетілетінін көрсетеді. Қолдау мен сатушыларға біреу «бұл әлі X істей ала ма?» деп сұрағанда жіберетін сілтеме береді. Сондай-ақ пікірді жабудың орны: сұралған функция шыққанда, оған сілтеме беретін өзгерістер жазбасы. Егер клиенттік кері байланыс порталын жүргізсеңіз, жеткізілген сұрауларды тікелей сол жазбаларға байланыстырыңыз.

Өзгерістер парағы — ішкі коммит тарихыңыз емес. «Billing қызметін қайта құрылымдау» пайдаланушыға ештеңе білдірмейді. «Шоттарда енді компанияңыздың ҚҚС нөмірі көрсетіледі» — білдіреді.

Беттің не керек екені

Әр жазбаға мазмұн

Беттер

• Өзгерістер индексі: ең жаңасы алдымен, тег сүзгілері және қарапайым беттеу немесе «көбірек жүктеу».
• Жазба беті: әр URL-де бір жазба, сондықтан оған сілтеме жасауға және бөлісуге болады.
• RSS немесе Atom арнасы: адамдар мен құралдарға email-сіз жаңартуларды бақылауға мүмкіндік береді.
• Әкімші беті (тек дерекқорлы нұсқада): жазбаларды жазу, алдын ала қарау, жоспарлау және жариялау.

Қолданба ішіндегі қосымшалар

• «Жаңалық не» белгісі: қолданушы көрмеген жазбалар болғанда мәзір элементіндегі нүкте. Қолданушы ашқан соңғы жазбаның күнін әр қолданушыға немесе браузерде сақтаңыз.
• Email дайджесті: келісім берген пайдаланушыларға жіберілетін қорытынды. Бұған жіберу провайдері керек; қолданбадан хаттар жіберу мақаласын қараңыз.

Негізгі шешім: файлдар немесе дерекқор

Жазбалар сайттағы файлдар ретінде

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

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

Дерекқордағы жазбалар және әкімші беті

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

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

Адамдар оқитын жазбаларды жазу

• Пайдаларынан бастаңыз. «Есептерді Excel-ге экспорттау» — «Жаңа экспорт модулі» деген сөзден жақсы.
• Кімге қолжетімді екенін айтыңыз. Барлық жоспарларда, тек Pro үшін, осы аптада іске қосылады.
• Көрсетіңіз. Бір скриншот немесе қысқа клип.
• Кішкентай түзетулерді топтаңыз. Апта сайынғы «Түзетулер мен жақсартулар» жазбасы тармақтармен парақты толтырып жібермейді.
• Алып тастауларда анық болыңыз. Бір нәрсе жойылса, қашан және оның орнына не қолдану керектігін айтыңыз.

Жұмыс істейтін бірінші сұрау

Біздің сайтқа /changelog бетінде ашық өзгерістер парағын қосыңыз. Әр жазба — тақырыбы, күні, тегі (New, Improved немесе Fixed), қосымша мұқаба суреті және мәтіні бар Markdown файлы. Индекс беті жазбаларды ең жаңасынан бастап, күні, тегі және бірінші абзацымен тізімдейді, тег сүзгі түймелері бар, және бетіне 10 жазба шығарады. Әр жазбаның өз беті бар, /changelog/<slug>, іздеу жүйелері үшін дұрыс бет тақырыбы мен сипаттамасы бар. /changelog/rss.xml мекенжайында RSS арнасын қосыңыз. Үш үлгі жазба жасаңыз. Қолданыстағы сайт дизайнына сәйкес келсін, телефонда оқуға ыңғайлы болсын және беттер тез жүктелуі үшін алдын ала рендерленсін.

Дерекқорлы нұсқа үшін бірінші сөйлемді мына сөйлемге ауыстырыңыз: «Жазбаларды жариялау күйі және жариялау күні бар дерекқорда сақтаңыз, және жазып, алдын ала қарап, жариялау үшін парольмен қорғалған әкімші бетін қосыңыз.»

Құрастыру қадамдары

1. Файлдар немесе дерекқорды таңдаңыз жоғарыдағы кестені пайдаланып.
2. Индекс пен жазба беттерін құрастырыңыз бірнеше үлгі жазбамен.
3. Тегтер мен сүзгілерді қосыңыз.
4. RSS арнасын қосып, оны беттен сілтеме жасаңыз.
5. Әр жазбаға бет тақырыбын, сипаттамасын және сайт картасы жазбасын қосыңыз. Негіздерін AI көмегімен жасалған сайттарға арналған SEO мақаласында табасыз.
6. Әкімші беті және кіру, дерекқорлы нұсқаны таңдасаңыз.
7. Қолданбаңыздағы «жаңалық не» белгісі.
8. Соңғы бірнеше айдың нақты жазбаларын жазыңыз, парақ бос басталмасын.

Жиі кездесетін қателер

• Коммит хабарламаларын көшіру. Пайдаланушыларға жазыңыз, әзірлеушілерге емес.
• Әр жазбаның URL-і жоқ бір үлкен бет. Ешкім нақты өзгеріске сілтеме жасай алмайды, ал іздеу жүйелері көптеген бетінің орнына бір бет көреді.
• Жаңартулар бір айдан кейін тоқтайды. Бір жыл бұрын соңғы рет жаңартылған өзгерістер парағы өнімнің тасталғанын көрсетеді. Сақтай алатын ырғақ белгілеңіз.
• Жазбаларды тек браузерде жүктеу. Іздеу жүйелері мен сілтеме алдын ала көрулері бос бетті көруі мүмкін. Алдын ала рендерлеңіз немесе серверде рендерлеңіз.
• Оқиғаларды араластыру. Үзілістер мәртебе бетіне жатады, өзгерістер парағына емес.

Дайын хостингтік құрал қай жағдайда жақсырақ

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

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

Mythex-пен құрастыру

Mythex-те агентті бар жобаға өзгерістер парағын қосуға немесе оны жеке шағын сайт ретінде құрастыруға сұрай аласыз және оны құрастыру кезінде тікелей алдын ала қарау терезесінде көресіз. Файлдық нұсқаға дерекқор керек емес. Әкімші нұсқасын таңдасаңыз, жазбаларды сақтау керек болғанда агент арнайы Postgres дерекқорын қосады (немесе /database теріңіз), ал скриншоттар жоба файлдарының сақтауында тұрады. Әкімші кіруін өз аутентификация тәсіліңізбен қосасыз (кіруді қосу рецепті).

Жаңа Mythex қолданбалары көбінесе клиент жағында рендерленетін бір беттік қолданбалар болады, ал SEO рецепті оларды іздеуге әлсіз деп атап көрсетеді; сондықтан жазбалар іздеуде табылуын қаласаңыз, өзгерістер беттерін статикалық немесе алдын ала рендерленген етуді сұраңыз. Дәл осы рецепт тақырыптар, сипаттамалар және сайт карталары туралы айтады. Кірістірілген өзгерістер парағы бар бастапқы үлгі үшін өнім білім орталығы үлгісін қараңыз.

Сұрақтар