Прозрачно и максимально доступно написанная (и переведенная к тому же на русский!) инструкция по Семантическому Версионированию от соучредителя GitHub https://semver.org/lang/ru/spec/v2.0.0.html

#versioning #en #ru

Все мы знаем про Семантическое Версионирование (RU) https://semver.org/lang/ru/ (EN) https://semver.org/, наткнулся тут на более лирическую, кхм, версию, сентиментальную и чувстввенную, так сказать. Sentimental Versioning http://sentimentalversioning.org/ — нарративная документация as is

#versioning #en

Пример лирического версионирования Ноды, аж в сердечке колет

#versioning #example #en

Еще немножко про версионирование, в этот раз предлагаю ознакомиться с календарной нумерацией релизов, ну как в Убунте https://calver.org/

#versioning #en

У нас уже было как-то про версионирование, вспоминали про semver, забавный semantical versioning и конечно же calver. А тут (в 2018) чуваки сделали под себя гибрид semver + calver, но с кошаками. I present to you Semancat versioning!
https://blog.avatao.com/semancat-versioning/

#versioning #en #article

👅 Языки:

#ru | #en

👷 Карьера:

#career — советы и всемозможные статьи о карьере техписателя
#conference — техписательские конференции, их записи и заметки
#resources — ресурс для саморазвития
#article — полезная статья, которая учит чему-то клёвому, что позволит стать более лучшим писателем
#vacancy — интересная вакансия или что-то связанное с наймом
#video — видео, видос, видосичек, видосюлька. И подкасты!
#book — книга/хендбук
#courses — курсы, программы для технических писателей

🛠 Технологии:

#tool — полезная утилита/приложение
#changelog — все о чейнджлогах, примеры, правила
#markdown — все о языке разметки Markdown
#reStructuredText — все о языке разметки reStructuredText
#asciidoc — все о языке разметки asciidoc
#LaTeX — все систему набора и вёрстки и язык разметки LaTeX
#ide — среды разработки и все что с ними связано
#vscode — все о Visual Studio Code, настройка, плагины, хитрости
#SSG — JAMStack, генераторы статических сайтов, Hugo, Jekyll, Antora, etc.
#testthedocs — тестирование документации, линтинг
#API — про документирование API, примеры, лайфхаки, подсказки
#diagram — про диаграммы (много про diagrams as a code), mermaid, UML
#screenshot — все про скриншоты, утилиты, сервисы и красивенькие фотоснимки экрана
#ai — про GPT, GitHub Copilot и прочее, где ИИ помогает нам писать

🧺 Общее:

#tonevoice — о правилах общения в документации
#language — что-то конкретно о языке, в основном английский
#legal — юридическая документация, лицензии
#styleguide — все о стилях и правилах
#DocsAsCode — все про подход к документации как к коду
#example — примеры документации (хорошие и плохие)
#uiux — интерфейсы, текст в интерфейсах, пользовательский опыт
#knowledgemanagement — менеджмент знаний, хранилища, тулзы, техники, советы и наблюдения
#versioning — про версионирование
#accessibility — все об аксессебилити в документации
#checklist — чеклист/шпаргалка
#vintage — винтажная документация, старые компьютеры, софт, техника, игры
#visual — про визуальную составляющую документации
#metrics — все о метриках документации
#random — что-то совсем косвенно относящееся к техписательству, юморески

Предлагайте новые хэштеги в комментариях!