Почему я ушёл от Atom обратно к VS Code

Дано: технический писатель, разрабатываю документацию в Asciidoc, всё люблю "из коробки", два года работал с VS Code, затем по рекомендации коллег перешёл на Atom.
Несколько месяцев проработал с Atom и вернулся обратно к VS Code, ниже делюсь впечатлениями.

В Atom отсутствуют рабочие пространства. Ну или я их не нашёл.

Git Blame в Atom есть только в виде таблицы, не нашёл GitLens, чтобы прямо над каждой строкой было.

Установленный терминал, а встроенного терминала в Atom нет, игнорирует символ _ в названиях веток и тексте.

Установленный терминал открывается с помощью Ctrl+Shift+T, но как его закрыть обратно? Такого хоткея я не нашёл, ну или плохо искал. В VS Code всё решается одним хоткеем.

Иногда Atom "вылетает" без объяснения причин. Мелочь, но отвлекает.

Чтобы установить новый Package в Atom, нужно зайти в Welcome Guide и только там выбрать Install a Package. Какой-то сложный UX.

Время от времени Atom плохо индексирует проект, и зачастую невозможно найти файл сразу после запуска Atom. Иногда дело доходило до использования grep.

Не нашёл удобный package для работы с TODO в Atom.

Непонятно, какой комбинацией клавиш в Atom можно перенести окно вправо вместо того, чтобы нажимать на окно правой кнопкой и выбирать Split Right.

Внешний вид в VS Code просто приятнее. Но это вкусовщина.

Поиск команды и файла разделены разными комбинациями в Atom. В VS Code это сделано в одном окне.

Asciidoc preview - невозможно обновить окно, чтобы посмотреть изменения. Сам предпросмотр обновляется не сразу, я не понял логики обновлений.

Asciidoc preview - не пролистывает исходный файл при прокручивании Preview.

Asciidoc Preview - не показывает JSON при include.

После переключения на другую ветку, Atom метит файлы с прежней ветки как несохраненные и спрашивает, сохранить ли. Иногда это сбивает с толку. VS Code же помечает файл как удалёнынй и ничего не предлагает с ним делать. Это удобнее.

Преимущество Atom: более насыщенный цветами синтаксис Asciidoc, лучше обозначены элементы контента. В VS Code цветовая гамма скромнее.

Общие впечатления: Atom хороший редактор, но VS Code мне нравится больше и он субъективно удобнее.

Небольшая шпаргалка по Graphviz, где я рассказываю о неочевидных моментах при разработке диаграм:

http://getdocument.ru/2020/06/27/unobvious-in-graphviz/

Пиши проще

17-го сентября 2020 года, в 18-00 МСК будет доклад "Пиши проще". Выступать буду я, Антон Самарин, технический писатель в компании NXLog. Покажу простые приёмы, которые улучшают техническую документацию на уровне документа, абзаца, и предложения.

Аудитория документа, знаки препинания, оптимальная длина абзацев и предложений, канцеляризмы, лишние слова - об этом будет мой небольшой рассказ. Приглашаю аналитиков, технических писателей и всех, для кого важен навык простого и понятного письма.

Ссылки для регистрации будут чуть позже.

Ссылка для регистрации на доклад "Пиши проще":

https://sysanschool.timepad.ru/event/1427811/

Ссылка на YouTube, где будет проходить трансляция:

https://www.youtube.com/watch?v=4nXYweoVJiE

Вебинар Пиши проще

Ссылки на презентацию и запись вебинара :

http://getdocument.ru/2020/09/17/write-it-easy-links-to-materials/

Всем привет! Ищем себе коллегу-техписателя в компанию NXLog.

Почему у нас хорошо
Наш труд внутри компании котируется наравне с трудом разработчиков.
Хорошая документация - наше преимущество, которое позволяет нам успешно конкурировать.
А ещё у нас всегда интересные задачи и новые технологии, которые нужно изучать.

Что мы делаем
Разрабатываем документацию для раздела https://nxlog.co/documentation
Посмотрите её чтобы лучше понять работу. И посмотрите язык, на котором она написана.

Условия труда
Удалёнка, почасовая оплата труда в долларах США.
Работаете когда хотите: в любое время суток, в любой день недели. Главное - отработать нужное количество часов в течение месяца.
Оплачиваемый отпуск.
Международная команда людей, приятно общаться и обращаться с вопросами.
Основной состав находится в Венгрии, поэтому живём по европейскому времени. Никаких ночных созвонов :)

Оплата труда
Деньги переводят на банковский счёт один раз в месяц. Без задержек и отговорок.
Можно работать в статусе самозанятого и платить 6% от поступления, если вы из России.

Что нужно для работы
- Отсутствие страха к разным штукам, преимущественно из мира Linux. Примеры из моей практики: osquery, Nagios Log Server, Microsoft ATA, Linux Audit System, Docker, Windows EventLog, Systemd, много их.
- Отсутствие страха к разным операционным системам: Linux, Windows, очень редко FreeBSD.
- Иметь приемлемый уровень английского. Native level не нужен, поскольку ревью делает коллега из США, и нам до него далеко.
- Скиллами сисадмина обладать не нужно. Но нужно быть готовым всегда изучать новые технологии и постоянно развиваться, на это в компании дают достаточно времени.
- Компьютер с 16Гб оперативки чтобы запускать виртуалки. Иногда нужно сразу работать с тремя виртуальными машинами.

Как построена работа
- Заходим в Gitlab, берём задачу, работаем.
- Создаём merge request, делаем коммиты.
- Если нужно, тестируем NXLog, описываем результаты, делаем коммиты.
- Назначаем задачу для ревью.
- Исправляем контент после ревью. Передаём его для слияния в master.
- Через 2-3 недели видим результат работы в открытом доступе. Можно показывать свою работу родным и близким, без всяких NDA :)

Наши инструменты
- Gitlab
- Asciidoc
- Git
- Редактор вроде Atom или VS Code

Контакты и адреса
С вопросами обращайтесь ко мне в Телеграм, @a_samaranche
Официальная страница с вакансией: https://nxlog.co/careers

Город ИТ

Школа системного анализа и Евгений Галактионов, в этом году, в рамках конференции Город ИТ будут проводить тематическую секцию "Системный анализ". Приходите, будет интересно.

Подробности: https://gorod.it/20/analysis

Всем привет.

24-го и 25-го апреля этого года Школа системного анализа и проектирования проводит онлайн-конференцию SYSTEMS x DESIGN: Проектирование успешных IT-систем.

Подробности о конфереции и приглашённых экспертах - по ссылке .

Всем привет! Из понравившегося за последнее время, ну т.е. за последние 1,5 - 2 года:

1. Хороший материал от DIVIO про типы документации и организацию, очень полезно: https://documentation.divio.com/
Впечатления: после просмотра видео я наконец-то начал понимать и различать типы документации.

2. Бесплатный курс по английскому языку для технических писателей от Stepik: https://stepik.org/course/684/promo
Впечатления: вначале кажется скучным, но процесс познания начинается со второй половины курса.

Остаёмся на связи :)

12 апреля, во вторник вечером, встречаемся на новом канале и слушаем продолжение лекций посвященных памяти Ф.П. Тарасенко и П.Ф. Тарасенко.
Ярослав Лопухин расскажет про Технологию решения проблем которую предлагает Прикладной системный анализ.
https://sistemnyy-podkhod.timepad.ru/event/1983546/

28-29 мая состоится CodeFest 12 - крупнейшая за Уралом конференция для ИТ-специалистов.
В этом году на конференции будет целый ряд выступлений по тематике системного и бизнес-анализа.
Из выступлений можно будет узнать:
- Как аналитику планировать свою работу в рамках проекта;
- Какой набор артефактов лучше всего создавать при разработке требований к информационным системам;
- Как ТРИЗ может помочь при проектированию ИС.
На подходе в программу ещё несколько выступлений по актуальным для аналитиков темам .
Так же можно будет поучаствовать в дискуссии про то, чем отличаются анализ и аналитика, и к чему ведёт путаница при использовании этих понятий.
И главное! Это можно будет пообщаться и обменяться опытом!

Итак, представляю вам новый телеграм-канал для тех кто интересуется системным подходом, прикладным системным анализом и другими системными дисциплинами, а также практикой их применения в ИТ.

Встречайте: https://news.1rj.ru/str/systemspodhod