Горячее
Лучшее
Свежее
Подписки
Сообщества
Блоги
Эксперты
Войти
Забыли пароль?
или продолжите с
Создать аккаунт
Я хочу получать рассылки с лучшими постами за неделю
или
Восстановление пароля
Восстановление пароля
Получить код в Telegram
Войти с Яндекс ID Войти через VK ID
Создавая аккаунт, я соглашаюсь с правилами Пикабу и даю согласие на обработку персональных данных.
ПромокодыРаботаКурсыРекламаИгрыПополнение Steam
Пикабу Игры +1000 бесплатных онлайн игр
“Рецепт Счастья” — увлекательная игра в жанре «соедини предметы»! Помогите Эмили раскрыть тайны пропавшего родственника, найти сокровища и восстановить её любимое кафе.

Рецепт Счастья

Казуальные, Головоломки, Новеллы

Играть

Топ прошлой недели

  • AlexKud AlexKud 38 постов
  • SergeyKorsun SergeyKorsun 12 постов
  • SupportHuaport SupportHuaport 5 постов
Посмотреть весь топ

Лучшие посты недели

Рассылка Пикабу: отправляем самые рейтинговые материалы за 7 дней 🔥

Нажимая кнопку «Подписаться на рассылку», я соглашаюсь с Правилами Пикабу и даю согласие на обработку персональных данных.

Спасибо, что подписались!
Пожалуйста, проверьте почту 😊

Помощь Кодекс Пикабу Команда Пикабу Моб. приложение
Правила соцсети О рекомендациях О компании
Промокоды Биг Гик Промокоды Lamoda Промокоды МВидео Промокоды Яндекс Директ Промокоды Отелло Промокоды Aroma Butik Промокоды Яндекс Путешествия Постила Футбол сегодня

IT юмор + Обучение

С этим тегом используют

IT Программирование Юмор Картинка с текстом Программист Скриншот Мемы Образование Учеба Урок Английский язык YouTube Все
40 постов сначала свежее
3892
tproger.official
tproger.official
2 года назад
Типичный программист

Зарисовка: разработчик и обучающие видео⁠⁠

IT юмор IT Программист Программирование Обучение Видео
63
3
skaynet25022022
skaynet25022022
2 года назад
Лига программистов

Интервью с IT-рекрутером из банка ТОП-10⁠⁠

Интервью с IT-рекрутером из банка ТОП-10 Программист, Обучение, Программирование, IT, Работа, Собеседование, Профессия, Поиск работы, IT юмор, Длиннопост

Публикую интервью с подписчицей моего канала IT-Старт IT-рекрутером Марией из банка ТОП-10


– Что важнее, опыт кандидата или образование?

– Какие специалисты реально востребованы?

– Как лучше кандидату составить своё резюме?


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


Начинаем. Буду благодарен за отзыв об интервью в комментариях поста.


Кто такой IT-рекрутер и чем он занимается?

Это сотрудник компании или кадрового агентства, который занимается поиском и привлечением ИТ-специалистов на открытые вакансии. ИТ-рекрутер работает с большим количеством источников (сайты по поиску работы, Telegram, проф.форумы, LinkedIn, GitHub, Хабр Карьера, соц.сети). Его задача – соединить специалиста и работодателя, чтобы они жили долго и счастливо ;)


Существует мнение, что заработная плата чуть ли не десятикратно превышают заработную плату обычного менеджера продаж из салона связи. Насколько это суждение близко к истине?

Не совсем понятен вопрос – чья зарплата? Рекрутера или ИТ-специалиста? Но даже это не имеет значения, т.к. сравнение зарплат специалистов из различных отраслей некорректно. Спрос на ИТ-специалистов сейчас велик, это интеллектуальный труд, он ценится!


Эйджизм – дискриминация человека на основании его возраста. Есть ли у вас эйджизм по отношению к кандидатам на вакансии?

Нет, одну и ту же работу в принципе способны выполнять люди разного возраста, но тут вопрос скорее в другом, каков возрастной состав той команды, куда ищут человека и сможет ли вписаться новый сотрудник в действующий коллектив.


Как попасть в крупную компанию, не проходя 10 кругов HR ада и общения с людьми, которым до тебя и нет никакого дела?

Изначально неверный подход к поиску работы. Важно понимать, что поиск работы это тоже работа. Есть такое выражение и я с ним согласна. В корне неверно, что с кандидатом общаются люди, которым до него нет дела. Поверьте, работодатель точно также заинтересован в поиске хорошего специалиста на открытую вакансию, как и кандидат, которому нужна работа! В каждой компании в зависимости от наработанного опыта свои процессы подбора, у кого-то это один тех.собес после 5 минутного созвона с рекрутером, а у кого-то по неск.встреч, онлайн кодинг, тестовое. Для того, чтобы понимать что тебя ждет советую сразу уточнять эту информацию у вашего рекрутера в самом начале общения.


Многие считают, что it-рекрутеры сами не разбираются в предметной области и в языках программирования, в частности. Как с этим обстоят дела у вас? Понимаете ли разницу между JavaScript и Java?

Отвечу за себя, в подборе персонала я уже 10 лет и имела дело с различными вакансиями, начиная от продавца обуви и специалиста колл-центра до Топ-персонала в крупных банках, последние несколько лет я специализируюсь на тех.рекрутинге. Как думаете, могу ли я хорошо разбираться во всех тех сферах, куда я подбирала людей? Но, так как я с уважением отношусь к своим кандидатам и ответственно к своей работе, то всегда, прежде чем начать поиск, я изучаю предметную область. Хотя бы обзорно. Мне важно понимать, в чем особенности каждой конкретной должности, чтобы ответить на максимально возможное количество вопросов кандидата о работе, я знаю прямых конкурентов своей компании и в целом обладаю информацией о развитии отрасли. Эту информация я всегда ищу сама в открытых источниках или задаю вопросы нанимающим менеджерам. Считаю, что так должен делать каждый уважающий себя специалист. Но в мире информационных технологий все гораздо сложнее, чем во многих областях, поэтому на подбор ИТ-специалистов в большинстве компании выделены отдельные рекрутеры в связи со спецификой работы. В некоторых компаниях практикуется внутреннее обучение для рекрутеров, которое проводят тех.специалисты, наглядно рассказывают о технологиях, языках программирования. Также рекрутер всегда принимает участие в организованном им тех.интервью и слушает о чем идет речь. Так и усваивается информация. Экспертизой, конечно, ИТ рекрутеры не обладают, если только это не бывшие программисты, напр.


Исходя из вашего опыта, как часто приходится отказываться соискателям и по каким причинам?

Я отказываю крайне редко на этапе телефонного интервью, так как при поиске резюме я уже понимаю, какой человек нам нужен и не звоню просто так. Отказы бывают по двум причинам:

1. Человек ведет себя неадекватно (у меня такое было, человек был пьян) или например проявляет агрессию к работодателю,как к бренду (бывает личная неприязнь).

2. При уточнении опыта работы с конкретными технологиями выясняется, что человек не работал с ними, а просто «мимо проходил»/видел как это работает, но сам не погружался. В этом случае не буду тратить время тех.спецов на дальнейшее рассмотрение, но бывают и исключения. Все зависит от требований по вакансии. Отказы после тех.интервью почти всегда связаны с тем, что человек не подходит в проф.плане.


При составлении резюме, на какие моменты необходимо обратить внимание, чтоб увеличить шанс того, что it-рекрутер заинтересуется и назначит встречу?

Вот это очень важный вопрос! Вы должны составлять резюме исходя из того, что вы знаете и умеете + чем вы хотите заниматься. Важно четко и ясно описать то, чем вы занимались ранее:

1. Кратко опишите проект, в котором работали (коммерческий или пет проект) + дайте ссылку на сайт/гитхаб.

2. Опишите сам функционал. Начинаем с основного функционала – на него делаем упор (бывает, что сложно сформулировать, но придется подумать или поискать резюме людей с похожим опытом для вдохновения).

3. Опишите стек. В случае составления резюме краткость не будет сестрой таланта, лучше раскрыть свою мысль, чтобы у рекрутеров и нанимающих менеджеров было меньше возможностей додумать что-то за вас. Но и писать много лишнего тоже не стоит, если вы лишь «потрогали» что-то или постояли рядом, то писать не надо. Это собьет с толку и запутает людей на той стороне.

Пишем весь свой опыт (если на одном проекте вы работали от разных юр.лиц – объедините их в одну запись, если в опыте работы есть большие пробелы – напишите чем занимались это время (обучение, отдых, лечение, фриланс+ссылка). Составьте резюме и дайте его почитать кому-то из друзей, спросите все ли им понятно и не возникает ли вопросов. Напишите свой контактный телефон, ТГ, все контакты, чтобы с вами было легко связаться.


Насколько сильная «текучка» кадров среди того количества кандидатов, что были наняты вами за последний год?

ИТ-рекрутеры не отслеживают текучесть персонала. Но отмечу, что количество открытых вакансий в связи с увольнением в общей массе крайне мала (это у меня так), отсюда делаю вывод, что практически все нанятые мной кандидаты за последний год продолжают работать.


Запись в трудовой, уровень образования, сертификаты, пройденные курсы, статьи на специализированных форумах, рекомендательные письма и реализованные проекты – что из выше перечисленного имеет максимальный вес для ИТ-рекрутера при рассмотрении резюме кандидата?

Вес имеет реальный опыт и ваши достижения. Некоторые заказчики обращают внимание на сертификаты (но это касается senior специалистов под определенной сложные задачи). В трудовую заглядывают уже при трудоустройстве, а рекомендательные письма – просто формальность. Главное – всегда реальный опыт.


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

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


Оформление предложения о работе – чаще всего это стек требуемых технологий и запись о наличии неограниченного количества печенек. Вопрос – когда же начнут нормально оформлять предложение о работе, с подробным описанием должностных обязанностей, описанием компании и её деятельности, контактные данные, схему проезда в офис организации?

Вакансии пишут рекрутеры с привлечением тех.специалистов. Не все тех.спецы умеют удачно формулировать требования, поэтому им нужна помощь. Не все рекрутеры понимают что пишут – им тоже нужна помощь ;) Поэтому, часто можно увидеть весьма странные или размытые формулировки. Свои вакансии перед размещением я всегда редактирую и согласовываю с командой. Но многие просто используют шаблонное описание, поэтому стоит задавать прямые интересующие вас вопросы рекрутеру уже при начале общения.


Почему в вакансиях редко указывается уровень заработной платы?

Зарплата зависит от уровня специалиста, его знаний и навыков, пула задач, с которым ему предстоит работать, нагрузок. Это не клоны, это высококвалифицированные спецы, поэтому и подход к зарплате для них индивидуален.


Бытует мнение, что активность на тематических ресурсах имеет огромное значение для кандидата при рассмотрении его кандидатуры. Насколько для вас важна активность кандидата на таких ресурсах как github и stackoverflow?

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


Используете ли вы в своей работе автоматическую рассылку без личного ознакомления с профилем кандидатов?

Я не использую, всегда сначала знакомлюсь с опытом кандидата, понимаю, нужен ли он нам, потом пишу, приглашаю. Хотя часто рекрутеры просто делают рассылки на эл.почты, а потом уже вступают в общение с ответившими кандидатами, уточняя его опыт.


Часто ли приходится игнорировать кандидатов?

Нет. Я всегда на связи с кандидатами, с которыми начато общение.


Насколько важно для кандидата (технического специалиста) умение общаться и коммуникабельность?

Очень важно! Для любого специалиста. По этому фактору оценивается как человек вольется в команду, комфортно ли будет с ним работать. Никто не хочет брать токсичных людей, а потом получить кучу проблем при работе с ними. Поэтому, важна будет доброжелательность, корректность в общении, внимательность, юмор и, самое главное, показатель того, что вы увлечены своей работой, «горите» ей (это самый важный фактор для джунов).


Обращаете ли вы внимание на хобби кандидата или никакой практической пользы от этой информации нет?

Рекрутеры не обращают на это внимание (если только там что-то совсем странное), вопрос о хобби может подниматься на уровне знакомства с командой, и то далеко не всегда, поэтому этот пункт необязателен. Хотя всякое бывает, например, при общении выяснится, что тим лид команды занимается мотоспортом и вы тоже, тогда это будет дополнительный балл вам в карму))


Так как работа с людьми сама по себе, мягко говоря, тяжелая в моральном плане + также стоит учесть, что в it «залезть» хотят многие, но навыков для этого хватает не всем и скорее всего из за отказов кандидатам вы часто встречаетесь с негативом в свой адрес. Часто ли происходит подобное и если происходит, как морально переносите это?

Соглашусь, что работа с людьми действительно тяжелая. Каждый день приходится общаться (переписываться, созваниваться) с десятками кандидатов, к каждому свой подход, у каждого свой характер. Бытует мнение, что рекрутер -вообще необязательный участник процесса, т.к. тех.спецом не является, хотя это не так – это как раз связующее звено, тот человек, на ком и держится весь процесс. Из особенностей – далеко не все отвечают на приглашения, но при этом сами требуют обратную связь. Кто-то не понимает причин отказа и пытается выместить свою злость на рекрутере (за 10 лет моей работы было всего три случая откровенной агрессии в мой адрес, хотя решение об отказе принималось не мной), в основном же люди адекватно реагируют и благодарят. Поэтому своих кандидатов я люблю.


Специалисты с какими компетенциями и знаниями каких языков программирования сейчас остро необходимы рынку труда и также требуются в вашей компании?

Приветствуется опыт работы с современным стеком, а именно микросервисной архитектурой, ELK, с высоконагруженными сервисами, работающими 24/7. Мобильная разработка, бэкенд (Java, Python), фронтенд (JavaScript, Typescript, React) – у каждой компании свои потребности. Набирает популярность Golang, Kotlin. О том какой стек в интересующей вас отрасли/компании всегда можно посмотреть в описании вакансий или на карьерных сайтах компаний. Просмотрите вакансии, составьте обзоры на те компании, которые интересны вам.


Как сильно изменилась ситуация с приемом на работу новых кандидатов после начала всем известных событий?

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


Подводя итоги. Какие рекомендации вы могли бы дать тем людям, что хотят успешно трудоустроиться?

1. Продумать свою стратегию поиска: разместить резюме на HeadHunter и Хабр Карьер, в каналах ТГ, на форумах, подписаться на каналы ТГ об открытых вакансиях интересующих вас компаний, привлечь к помощи знакомых (самый лучший вариант для джунов), создать и заполнить профиль на LinkedIn, наполнить github.

2. Грамотно написать резюме с упором на практический опыт и реализованные проекты, дать его почитать коллегам/друзьям.

3. Технически подготовиться к тех.интервью – посмотреть онлайн собеседования по вашей специальности на ютубе, почитать статьи на Хабре, где нанимающие менеджеры рассказывают о вопросах, которые задают, пообщаться с друзьями/коллегами на тему как там у них. 4. После тех.интервью попросить (но не требовать) обратную связь, чтобы понимать где слабые места и пробелы в знаниях.

4. Морально настроиться, не переживать, высыпаться и все получится!


--Конец интервью--

Если интервью показалось вам интересным, то буду благодарен за подписку на мой канал

IT-старт t.me/it_begin

где я также публикую обзоры технической литературы и полезную информацию как для действующих, так и для начинающих программистов.

Интервью и обзоры книг также публикую на своём сайте russia-it.ru

Показать полностью 1
[моё] Программист Обучение Программирование IT Работа Собеседование Профессия Поиск работы IT юмор Длиннопост
3
591
DELETED
2 года назад
IT-юмор

Ответ на пост «Главные ошибки при учёбе на программиста»⁠⁠1

Главная ошибка программиста - не тестировать свой код или неумение тестировать. Они считают, что либо тестеры, либо пользователи, а им главное просто писать. Пишут много кода и сразу его не проверяют. Потом выходит плавающая ошибка, на которую потратишь больше времени, чем на то, чтобы переписать всё правильно.


Вот был у нас был такой один, писал как Бог, со скоростью 100 строк в минуту. Хорошо всё знал. Но блин не тестит и всё тут. Он даже не представляет как тестить. Очень приблизительно может представить себя по ту сторону программы. Как робот. Не представляет всей совокупности факторов, нюансов работы пользователя. Поэтому к нему всегда приставляли проверяющего, а это уже сильно сказывалось на производительности команды.

[моё] Ошибка Обучение IT IT юмор Программирование Текст Цифры Ответ на пост
116
416
MirZz
MirZz
2 года назад
IT-юмор

Главные ошибки при учёбе на программиста⁠⁠1

Ошибка 1. Не учить английский язык.

Ошибка 2. Поиск информации по коду в google на русском языке, а не на английском.

Ошибка 3. Избегание самого главного в Clean Code — правильных названий.

Ошибка 4. Несоблюдение принципов SOLID

Ошибка 5. Отсутствие декомпозиции задач — когда большая задача не дробится на части, когда не составляется алгоритм успешного достижения завершения задачи.

Ошибка 6. Стрематься выяснить детали задачи у заказчика, ментора, буду читать мысли и делать всё наугад.

Ошибка 7.

1. Буду гуглить до посинения (неделю, месяц), но не спрошу у мастера, как делается определённая вещь.

2. Пальцем не пошевелю в сторону гугла, пойду сразу терроризировать мастера, пусть объясняет как делается определённая вещь.

Ошибка 8. Считать, что программирование — это легко, и я выучусь за 2 месяца.

Ошибка 9. Назову репозиторий в Git "блудная кастелянша в уборной", никнейм в Git — aHaruJl9IToP, таблицу в базе данных — "лошади с детородными органами".

Ошибка Обучение IT IT юмор Программирование Текст
152
7289
DELETED
2 года назад
IT-юмор

Обучение программированию по роликам на Ютубе⁠⁠

Обучение Программирование IT IT юмор YouTube Видео Без звука
156
83
stavropol
stavropol
2 года назад
IT-юмор

Пользователь Vim на обучении⁠⁠

*Vim — это специализированный текстовый редактор. У новичков бывают трудности с выходом из него.

localhost

Показать полностью
IT юмор Vim Программирование Пользователи Обучение Видео
26
13
pro.analitika
pro.analitika
3 года назад
Лига программистов

Неудобные вопросы⁠⁠

Если тебе задают неудобный или провокационный вопрос, то надо переформулировать его в выгодную и удобную тебе форму и отвечать уже на него.

Например,

❌Слышал, что комплектующие для ИТ-системы были куплены некачественные и однажды это привело к остановке услуг на Х часов. Это правда?

✅Вы спрашиваете, стабильна ли наша система? Да, безусловно!

Думаю, что идея стала понятнее после примера.

Эту технику часто применяют в публичных выступлениях, но нам же никто не запрещает ее использовать и в переговорах. Главное, не злоупотребляйте 🤌🏻😂

И начинай практиковать, ведь теория без практики не имеет результатов.

[моё] IT Программирование Программист IT юмор Обучение Разработка Собеседование Урок Windows Мотивация Текст
16

Оформить подписку для бизнеса

Перейти
Партнёрский материал Реклама
specials
specials

Ваш бизнес заслуживает большего!⁠⁠

Оформляйте подписку Пикабу+ и получайте максимум возможностей:

Ваш бизнес заслуживает большего! Малый бизнес, Предпринимательство, Бизнес

О ПОДПИСКЕ

Малый бизнес Предпринимательство Бизнес
Grolribasi
Grolribasi
3 года назад
Лига программистов
Серия Грол-о-работа

Сравнение возможностей AsciiDoc и DITA⁠⁠

Всем лучи добра! Меня зовут Сергей Карасёв, но вы можете звать меня просто Саня. Я работаю техническим писателем в одной компании. Расскажу вам о двух Docs as Code инструментах. На случай, если вы делали документацию в ворде или ещё где-то, а теперь решили отделить форматирование от документации и захотели "чтобы было чисто!". Побуду сегодня вашим Мистером Пропером.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Когда я только пришёл в компанию, наша документация была на DITA. Но потом мы решили модернизировать документацию, вывести в онлайн, чтобы была разбивка на версии, чтобы всё было красиво и т.д. и т.п. Подробнее можно прочитать вот здесь и вот тут.


То есть я работал с Дитой, и я работал с AsciiDoc, поэтому в какой-то степени могу судить и сравнивать. Сравню аналогичные функции, расскажу об отличиях, плюсах и минусах каждого формата и т.д. Короче, всё чётко и по понятиям, как это делают у нас в Купчино.

Документация


DITA

Нельзя стать священником, не прочитав Библии.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

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


К счастью, есть Евангелие от Radu Coravu - документация от создателей Oxygen. Oxygen - это основной инструмент для работы с Дитой, но об этом позже.


Хочется чего-то более человечного? Есть свободное толкование Библии с примерами - Learning Dita. Очень помогло, когда я хотел лучше понять Диту.

AsciiDoc

Есть только одна Библия - сайт docs.asciidoctor. На сайте задокументирован весь синтаксис с очень удобной рубрикацией. Не знаете, как это сделать -- используйте поиск по сайту.


Есть ещё несколько мест, где можно найти документацию, но они либо неофициальные, либо устаревшие.


Я далеко не сразу нашёл Docs.AsciiDoctor. Кто победил? Пусть будет ничья.

DITA:AsciiDoc 1:1

Работа с исходниками

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

DITA

Исходники - обычный текст, который можно редактировать в блокноте. Проблема в том, что это XML с очень строгой структурой.


Иными словами: нужно иметь стальные... нервы, чтобы писать на дите в блокноте.

AsciiDoc

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


Иными словами: писать в блокноте можно без проблем.

DITA:AsciiDoc 1:2

Редакторы для работы с исходниками

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

DITA
Для Диты есть одна основная утилита - Oxygen. Это коммерческая и платная утилита. Есть ещё несколько утилит, но, честно говоря, они не очень удобные. Oxygen - это всё же канон. И стоимость у него каноничная.

А ещё новая версия несовместима со старой лицензией. Ну, разумеется.

AsciiDoc

Официального или единого редактора не существует. Но есть несколько редакторов, которые поддерживают AsciiDoc при условии установки плагинов:

- Atom - не пробовал, но выглядит норм, много плагинов.

- Visual Studio Code - с плагином AsciiDoc поддерживает синтаксис и большую часть функций.

- IntelliJ Idea - плагин поддерживает максимум функций и постоянно обновляется.

- AsciidocFX - утилита для работы с синтаксисом AsciiDoc. Поддерживает синтаксис.


Все утилиты для работы с Asciidoc абсолютно бесплатны.

DITA:AsciiDoc 1:3

Набор функций


Повторное использование

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

DITA

Все любят Диту за повторное использование кода.


Можно использовать целые топики или любые фрагменты. Но есть ограничения, в зависимости от разрешённых элементов. Oxygen не даст заимствовать запрещённые элементы, так что ошибиться сложно.


Заимствования делаются при помощи "conref" или "conref ... conrefend". Заимствовать один элемент или топик полностью - "conref". Заимствовать от и до - "conref ... conrefend".

AsciiDoc

Механизм повторного использования аналогичен Дите. Заимствовать один элемент или топик целиком - "include::topic.adoc[]". Заимствовать от и до чуть сложнее. Нужно создать два тэга:


//tag::magic-tag[]

Бла-бла-бла

//end::magic-tag[]


Затем заимствовать по тэгу: "include::topic.adoc[tags=magic-tag]".

DITA:AsciiDoc 2:4

Ключи

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

DITA

Сначала ключ нужно обозначить, затем задать ему значение, потом использовать его в нужных местах. Сделать это вне Oxygen будет очень сложно. Мне сложно сделать это даже в Oxygen, придётся рыться в заметках. Если честно, проще не использовать ключи.


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

AsciiDoc

Здесь ключи называются атрибутами, но суть та же. Определяешь в топике, потом используешь. Задаются атрибуты очень просто: ":attribute: значение". Использовать через "{attribute}", что заменится на "значение".


Область действия задать тоже можно, но не так просто в чистом AsciiDoc. Удобнее использовать Antora - генератор статических сайтов для AsciiDoc. Если не нужен сайт, то область действия ключей будет только в рамках топика или "карты".

DITA:AsciiDoc 3:5

Профили и фильтрация

DITA

Даже если вы знакомы с Дитой на уровне "знакомый по пьяни рассказывал", вы должны были слышать о невероятно крутом механизме профилирования.


На пальцах: это когда создаётся один документ на 15 страниц исходников.


Да, такой небольшой документ.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Из этих 15 страниц одной командой мы делаем три документа по 5 страниц каждый. При этом инструмент понимает сам, какие 5 страниц куда идут, и добавляет к каждому титульный лист и все остальные части.


Вот для этого в Дите есть специальные пометки - профили, ".ditaval файлы". В Дите это делается очень легко и удобно.

AsciiDoc

В AsciiDoc тоже есть схожий механизм, но тут больше ручной работы. Сначала нужно задать атрибуты на каждой странице, которую мы хотим включить в руководство и т.д. и т.п.


На пальцах проще: задаём три атрибута, один на 5 страниц, второй на 5 страниц и третий на 5 страниц. Ну и все три атрибута на титульнике. Запускаем билд, получаем три разных документа из одного большого.


Это посложнее, чем у Диты.


Есть три вида условий:

- ifdef - если атрибут определён, контент включается.

- ifndef - если атрибут определён, контент не включается

- ifeval - если атрибут равен условию, контент включается. Условия типа равен, не равен, больше, меньше и т.д.


Кстати, даже Антора не сильно упрощает профилирование. В чём-то даже усложняет. Зато так можно настроить область использования атрибута.


На пальцах: определил атрибут в главном топике, включил в него все остальные. В остальных определил ifdef, ifndef, ifeval. В зависимости от указанного в главном топике атрибута получишь разный результат. Можно создать несколько почти одинаковых главных топиков с разными атрибутами и быстро штамповать документы по 5 страниц.

DITA:AsciiDoc 4:5

Форматы экспорта и единый источник

Единый источник - это то, ради чего мы здесь сегодня собрались! То, ради чего в принципе переходят на docs as code.


Ага, здорово, а что это? Не все могут быть в курсе, поэтому быстро поясню. Единый источник - это когда из одного исходного кода можно получить несколько форматов документации. Например, получить сразу .pdf, .html, .doc(x), и не придётся конвертировать и поправлять -- результат всегда будет стабильно одинаковый.

DITA

Так вот, единый источник в виде Диты позволяет получить любое количество форматов. Но есть один нюанс.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Чтобы трансформации (по-народному - экспорт) работали, необходимо установить JDK и DITA OT (DITA Open Toolkit).


В принципе, можно обойтись и одним Oxygen, в него уже включено всё необходимое, но он платный.


В общем, вы поставили JDK, DITA OT и можете смело пользоваться всеми перками единого источника из коробки.


Из коробки доступны вот такие форматы:

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Можно также установить дополнительные плагины, чтобы иметь ещё больше форматов (смотри документацию DITA OT).


Но вы наверняка захотите, чтобы конечный документ соответствовал корпоративному стилю (проклятые капиталисты, при коммунизме-то всё одинаковое и никто не выпендривается!). Всё ещё хотите? Добро пожаловать в мир XSL-трансформаций!


- Не-не, я не подписывался на какие-то XSL-трансформации, я ничего о них не знаю!
- Это Дита, детка! Хочешь кататься на Дите, люби и XSL-трансформации.

Я ничего не знаю об XSL-трансформациях. Я не умею их создавать и редактировать тоже не особо умею. Я видел исходники, меня они впечатлили и напугали одновременно.


Короче, настроить свой плагин для трансформации сложно. Но возможно при определённых знаниях.

AsciiDoc

Здесь ситуация та же. Ну только что развернуть проще. Всё можно сделать из командной строки.

Есть вот такие встроенные конвертеры:

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

И вот такие официальные аддоны:

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Помимо этого, есть много разных "любительских" конвертеров. Это всё то, что за годы сделали пользователи AsciiDoc. Много разных форматов. Наверное, самый распространённый - это pandoc, который конвертирует ещё много чего много во что. Соответственно, настраивать внешний вид и стили можно по-разному. Введите в ваш любимый поисковик "asciidoc to нужный формат" и изучите результаты.


А ещё из Asciidoc можно создавать целые статичные сайты при помощи генератора статичных сайтов Antora.


- Вот ты говоришь "статичные сайты", а что это такое?
- Это обычный HTML-сайт, только без всяких лишних наворотов типа CMS, движка и прочего. Короче, не запаривайтесь, просто обычный сайт.

Можно создавать сайты с дефолтным или кастомным внешним видом. Причём в случае с сайтом настройка внешнего вида гораздо проще. Чтобы поменять ширину, цвета, шрифт, достаточно знать немного HTML и CSS.


Иными словами, это совсем не сложно, точно легче чем XSLT.


А ещё почти из любого редактора можно создать pdf, а то и нескольких видов.

Никому не дам балл. Создать трансформацию/конвертер со своим стилем не так просто ни в AsciiDoc, ни в Дите.


А чего я хотел? А хотел я, чтобы в идеале как с Antora. Чтобы максимально интуитивно и без всяких извращённых навыков. Ну, в идеале.

DITA:AsciiDoc 4:5

Обратная совместимость


Последний важный пункт, на мой взгляд. Кто-то скажет "а зачем мне обратная совместимость, и что ты вообще подразумеваешь под этим?"


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

DITA

Обычно все изменения Диты оперативно поддерживаются в новых версиях DITA OT. Только вот новая версия DITA OT вполне может сломать вашу созданную трансформацию. Ну вы просто не сможете обновиться и получить преимущества новой фичи, пока не обновите свой плагин. А это опять XSL-трансформации с кровью, потом и баттхёртом.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

AsciiDoc

Обратная совместимость AsciiDoc обычно не проблема. Новая версия всегда будет поддерживать прежние фичи, обновление не вызовет проблем. А если проблемы всё-таки могут возникнуть, то об этом обязательно будет сказано в списке изменений.


Серьёзно, я даже не знал, что так бывает. Что можно просто обновиться и всё будет работать, как раньше. Очень приятно.

DITA:AsciiDoc 4:6

Техническая поддержка

DITA

Чуть не забыл. Сама по себе Дита лишена какой-либо техподдержки. Максимум, на что можно рассчитывать - это помощь на StackExchange. Ну, ещё можно попробовать задать вопрос на форуме Oxygen. Скорей всего ответят.

AsciiDoc

Поддержка феноменальна. Можно спросить в чате AsciiDoc, на гитхабе или в твиттере.

Всегда ответит кто-то из сообщества или даже сам создатель.

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

DITA:AsciiDoc 4:7

Итог


При сравнительно похожем наборе функций AsciiDoc проще, чем DITA, а во многом даже превосходит её.


Дита выигрывает в повторном использовании, фильтрации и возможностях тонкой настройки ключей. У AsciiDoc отличная поддержка, обратная совместимость и редакторы для работы с исходным кодом.


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

Сравнение возможностей AsciiDoc и DITA Программирование, Разработка, IT, Программист, Урок, IT юмор, Обучение, Длиннопост

Всем лучи добра и качественной документации!

Заглядывайте в мой телеграм, если что. Пишу разные интересные и не очень вещи.

Показать полностью 14
[моё] Программирование Разработка IT Программист Урок IT юмор Обучение Длиннопост
5
Посты не найдены
О нас
О Пикабу Контакты Реклама Сообщить об ошибке Сообщить о нарушении законодательства Отзывы и предложения Новости Пикабу Мобильное приложение RSS
Информация
Помощь Кодекс Пикабу Команда Пикабу Конфиденциальность Правила соцсети О рекомендациях О компании
Наши проекты
Блоги Работа Промокоды Игры Курсы
Партнёры
Промокоды Биг Гик Промокоды Lamoda Промокоды Мвидео Промокоды Яндекс Директ Промокоды Отелло Промокоды Aroma Butik Промокоды Яндекс Путешествия Постила Футбол сегодня
На информационном ресурсе Pikabu.ru применяются рекомендательные технологии