Parawriter

Parawriter

Аудитория: 762 подписчика
Категория: Блоги
Канал технического писателя о текстах, работе в айти и ещё о чём-нибудь
———
Сотрудничество @novillero

Статистика канала

762 подписчиков

Последние посты

Parawriter
Просматривал недавно посты по тегу #карьера и понял, что пришло время выделить отдельную рубрику для образовательных курсов и прочих учебных штук, потому что таких публикаций накопилось уже достаточно. В общем, приветствуем новый хештег #учёбаВ прошлый раз, когда я хвастался своим почти оксфордским образованием, я упомянул реально крутые курсы по пайтону со степика.Вот они:Поколение Python: курс для начинающихПоколение Python: курс для продвинутыхЭто два последовательных очень подробных курса, которые в связке подойдут совсем новичкам, ещё даже не пытавшимся вывести заветное «Hello World».Следующие ступени поколения Python уже платные, поэтому их я рекламировать не буду. Скажу лишь, что цены там адекватные. Сам я прошел первую ступень для начинающих еще в 2022 году где-то за месяц-полтора в формате «как скоротать вечер». Очень надеюсь когда-нибудь собраться с силами и продолжить обучение.«Зачем техническому писателю пайтон?» — спросите вы.Конечно, это необязательный навык. Но понимание принципов объектно-ориентированного программирования и базовое знание какого-нибудь современного языка никогда не бывает лишним, особенно если вы метите в писатели-сеньоры)В общем, мой рекомендасьон, однозначно.#карьера #учёба
1 080
Parawriter
Привет! Как проводите весенние каникулы?Я прекрасно.Например, сегодня я клюнул на рекламу в гдетограме и стал студентом Оксфорда без регистрации и смс!Шучу, зарегистрироваться мне всё-таки пришлось)И это вроде как не совсем Оксфорд. В общем, обо всём по порядку.Есть такая популярная британская платформа онлайн-образования — Oxford Home Study Centre, которая предоставляет множество дистанционных курсов по самым разным направлениям и темам. От психологии отношений до риск-менеджмента и обратно.Но так как я до сих пор не обзавёлся валютным счётом, пришлось немного придержать аппетит, найти в меню сайта маааленькую кнопочку «free courses» и перейти на вкладку с бесплатными программами.Я поступил на курс по пайтон-разработке для начинающих:– 4 учебных модуля (введение в пайтон, функции, структура данных и основы объектно-ориентированного программирования)– 4 онлайн-теста– сертификат прохожденияИз интересного: разумеется, программа на английском языке, а ещё все учебные материалы надо скачивать в пдф.Мельком просмотрел первый модуль — в целом, неплохая базовая информация о том, как написать простенький скрипт, запустить его через консоль и провести отладку. Следующие модули откроются только после прохождения теста, так что пока ничего рассказать не могу)На практике конечно гораздо удобнее пользоваться отечественными платформами — например, моим любимым степиком (там есть очень крутой курс по пайтону с двумя бесплатными ступенями для начинающих и продолжающих). А Oxford Home Study Centre (который не аффилирован ни с одним университетом в Великобритании) имеет лишь два плюса: практика английского и красивый сертификат формата «сфоткай, типа я в Оксфорде».Но сертификат я обязательно получу)Если интересно, можете погулять по бесплатному разделу OHSC — тут, кстати, много программ по AI, если вы интересуетесь этой темой.Вывод: рекомендовать не рекомендую, но поиграться-почитать можно, вдруг найдете для себя что-нибудь интересное 🙃#карьера #учёба
918
Parawriter
Превью публикации
Привет!Почти год назад я выпускал серию постов по погружению в профессию технического писателя — их можно найти по тегу #онбординг или в одном из закреплённых постов. Мы разрабатывали первый документ, составляли резюме, искали релевантный опыт, придумывали карту компетенций для развития хардовых навыков.Параллельно я неожиданно для себя провёл несколько карьерных консультаций, и даже успешных.Вдохновившись, я подготовил персональный курс для погружения в профессию технического писателя. Итак, встречайте: Онбординг технического писателя: большой мастер-класс 🎆Вас ждут:– Четыре индивидуальных онлайн-встречи (45-60 минут) в форматах консультации и мастер-класса– Домашние работы с проверкой и обратной связью– Разработка плана дальнейшего профессионального развитияКаждая встреча стоит 2000 рублей. Домашние задания входят в стоимость)Так как это индивидуальный курс, у него нет чётко обозначенных сроков — мы проведём его в любое удобное для вас и для меня время.Для записи напишите мне в личные сообщения (профиль указан в информации о канале).Приходите, будет полезно и интересно! 🙃#практика #карьера
1 190
Parawriter
Пока все выясняют, кому доедать нижнюю часть кулича без глазури, хочу поговорить на какую-нибудь серьёзную тему.Дважды я поднимал базу знаний проекта с нуля — это, скажу я вам, непростая задачка! В первый раз я сделал всё не как по учебнику: не составил техническое задание, не провёл опрос пользователей, поменял на переправе основной инструмент, основываясь только на своём представлении о прекрасном.Когда мне снова подвернулась такая работа, я уже знал, как выполнить её с меньшими энергозатратами.Рецепт успеха в проектировании и создании классной базы знаний прост: нужно относиться к базе знаний как к продукту. И, соответственно, разрабатывать базу знаний как программный продукт.Что это значит? База знаний — это не архив, не библиотека и даже не справочный гайд. База знаний — это информационная система, состоящая из актуальной структурированной документации, а также инструментов и процессов для управления этой документацией. Поэтому перед проектированием базы знаний нужно ответить на три главных вопроса:1. Какие именно знания будут обращаться в нашей базе?2. Какие инструменты больше всего подойдут для организации нашей базы?3. Какие процессы работы с документацией подойдут нашей команде?Для этого нам придётся провести полноценное исследование: опросить пользователей, собрать требования, проанализировать предыдущий опыт команды или опыт смежных команд, изучить имеющиеся на рынке инструменты, подобрать подходящие метрики, на которые мы сможем опираться для оценки эффективности принятых решений.После, основываясь на полученных в ходе исследования данных, мы сможем подготовить полноценное техническое задание, по которому уже будем заниматься собственно проектированием и разработкой базы знаний.А на этапе проектирования и разработки нас ждёт масса интересного:1. Настройка инструментов2. Разработка структуры базы знаний3. Проектирование и организация процесса документирования4. Разработка стайлгайда и шаблонов5. Наполнение базы знанийНо это уже тема для отдельного поста 🙃Кстати, у меня почти готов целый доклад о создании классной базы знаний, который я хотел было пристроить на пару конференций, но не срослось. Так что, если вам интересно, я могу превратить этот доклад в статью и поделиться своим опытом поподробнее. Пожалуй, 40 птичек в реакциях к посту станут отличной мотивацией! 🕊#практика
960
Parawriter
Превью публикации
Работал я как-то с огромной базой знаний, количество статей в которой исчислялось сотнями, а возможно и тысячами. В таких больших системах неизбежно находится много так называемой легаси-документации: старые тексты трёхлетней давности, авторы которых ныне пребывают за пределами видимой вселенной, опубликованные черновики, написанные на коленке заметки, статьи-лоскутные одеяльца, руку к которым приложило несколько авторов...Впору открывать парикмахерский салон, чтобы всё это причесать (вычитать, обновить и переписать). Но рабочее время полностью уходит на текущие задачи, поэтому актуализация доки часто оказывается в глубоком бэклоге.Тогда мы придумали сделать систему статусов, которые можно повесить на любую статью так, что сразу будет видно — в каком состоянии готовности и актуальности эта статья находится.Мы придумали четыре статуса:NEW — новая, свеженькая статья. Статус висел месяц после публикации.DRAFT — черновик статьи. Статус присваивался материалам, которые уже были опубликованы, но ещё дописывались.DEPRECATED — неактуальная статья. Статус обозначает, что статья описывает неработающую функциональность и в скором времени будет перенесена в архив.ACTUAL — хорошая, актуальная статья. По сути, такого статуса не существовало физически, любая статья, не отмеченная другими статусами, по умолчанию считалась actual.Прошло время — теперь я работаю в другом месте и совсем с другой базой знаний, которая создаётся почти с нуля и растёт прямо на моих глазах. Я решил разработать систему статусов и здесь, чтобы самого начала формировать прозрачную и понятную структуру. К уже известным ACTUAL, DRAFT и DEPRECATED добавил ещё два:REVIEW — статья содержит неактуальную информацию и находится в процессе обновления.LEGACY — статья больше не поддерживается, использовать на свой страх и риск.Надеюсь, это поможет мне поддерживать чистоту и порядок в своей доке, которая стремительно развивается и увеличивается в размерах. А вы используете статусы или их аналоги в работе с документацией? Расскажите о своём опыте, будет интересно обсудить)Дисклеймер: рекомендую относиться к статусам с осторожностью и использовать их только в случае реальной необходимости, иначе это может превратиться в ещё один бюрократический процесс, от которых мы так стараемся избавиться.P.S. Хочу выразить благодарность моей коллеге Ире за помощь и техническую поддержку 🕊#практика
1 040

Оставить комментарий/отзыв

Рекомендации

Маргарита вдохновляет

Маргарита вдохновляет

@margo_kumok
576 подписчиков

Добро пожаловать в мой уютный мир! Здесь я делюсь атмосферой Санкт-Петербурга, вдохновляю на творчество, расс...

продам

продам

@nastyauu99
735 подписчиков

всем приветик!

Elenaonto

Elenaonto

@elenaonto
728 подписчиков

Здесь я рассказываю о стиле жизни , моих идеях, инсайтах, онтопсихологии и языке обстоятельств) мой сайт eluti...

Leekff

Leekff

@Leekfff
688 подписчиков

Юля/Leekff 18 y.o (22.07) 📍Члб

Heaven and Love

Heaven and Love

@heavenandlove
721 подписчиков

Чат: https://t.me/+B2psrl3UU_EzYzM6 Discord: https://discord.gg/qDAUrb45xv паблик VK: https://vk.com/heavenan...

𝘽𝘼𝙄𝙇𝙇𝙀𝙈𝙀𝙉𝙏💤ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ#GiveDeath2Luka # Пьербаттиста Пиццабалла #CEO–KAIVAT

𝘽𝘼𝙄𝙇𝙇𝙀𝙈𝙀𝙉𝙏💤ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ#GiveDeath2Luka # Пьербаттиста Пиццабалла #CEO–KAIVAT

@sleepSu
823 подписчиков

Лука киннам никогда не стать психически здоровымиㅤ ㅤㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ ㅤ Грамматические оши...

Со-Бытие 🌳

Со-Бытие 🌳

@sobytie_community
735 подписчиков

О создании общин и сообществ. Об умении находить общий язык. О быте, науке, культуре, истории, религии, семье,...

Анна Хрусталева путевОе

Анна Хрусталева путевОе

@hrustalevaAnna
745 подписчиков

РИПЛИМАНИЯ ВАНИША // 6.25 Wrestling // Rhea Ripley

РИПЛИМАНИЯ ВАНИША // 6.25 Wrestling // Rhea Ripley

@ripleymania625
771 подписчиков

Наблюдаем за господством Рии Рипли и обсуждаем рестлинг(и не только). ПРЕДЛОЖКА - @RipleyMania_Predlozhka_Bot

Гниль емае

Гниль емае

@gnilemae
713 подписчиков

http://t.me/anonimnyye_voprosy_bot?start=ty7uw (анон) @tvarsalnaya - я реп про миньонов https://t.me/+Rpnf2UdF...