Size: a a a

DocOps-сообщество

2019 September 18

NV

Nick Volynkin in DocOps-сообщество
Да, в HTML, который гитбук показывает
источник

ДС

Денис Старков in DocOps-сообщество
Уже завтра гляну, сейчас в дороге
источник

a

arvikon in DocOps-сообщество
Денис Старков
Привет! Есть у кого-нибудь опыт работы с gitbook? Возник вопрос по якорям в тексте. В файле .md сделал оглавление, к заголовкам прикрутил ссылки все стандартно: в оглавлении [header](#header) , у самого заголовка ссылка <a name="header"></a>
В репозитории все норм отрабатывает, а раскатали в gitbook - не аллё 🤔
В html5 атрибут name не поддерживается. Только id. Может в этом соль?
источник

ДС

Денис Старков in DocOps-сообщество
arvikon
В html5 атрибут name не поддерживается. Только id. Может в этом соль?
Возможно, надо почитать
источник
2019 September 19

NK

ID:0 in DocOps-сообщество
​​Сообщество Write the Docs на TeamLeadConf SPb.

Впереди TeamLeadConf SPb! Пока что я отдыхаю от конференций (т.е. просто работаю), а мои коллеги по сообществу Write the Docs придут. Приходите к ним на стенд с вашими вопросами про документацию.

Если хотите что-то обсудить заранее, приходите с вопросами в чат @docsascode.

Стенд будет выглядеть вот так:
источник
2019 September 20

АП

Александр Парень in DocOps-сообщество
Один из участников WTD Prague написал статейку своих мысле о DocsAsCode https://document360.io/blog/docs-like-code-is-it-worth-the-hassle/
источник

АП

Алексей Пахомов in DocOps-сообщество
Очень комерческим пост оказался IMHO
источник

АП

Александр Парень in DocOps-сообщество
Ну да каждый пиарится как может )
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Автор противопоставил документацию коду, приведя в пример зависимость от стилей и статики
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
...но это же буквально как фронтенд устроен
источник

ИУ

Илья Улеско in DocOps-сообщество
"I was shoking" (c). Да ладно =)
источник

ИУ

Илья Улеско in DocOps-сообщество
Напомнило классику, вот тут та же суть
источник

НН

Нац Нац in DocOps-сообщество
>Written by Saravana Kumar
>Saravana Kumar is the Founder/CEO of Document360
>Индус
источник

RK

Ruslan Kot in DocOps-сообщество
в статье прекрасно всё, можно сразу читать summary, закрывать ноутбук и идти пить какао на подоконнике
источник

NV

Nick Volynkin in DocOps-сообщество
Это напомнило мне одно описание курса по разработке документации. Сверстанное убого, как будто в Ворде. Хостилось на Битриксе.
источник

NV

Nick Volynkin in DocOps-сообщество
Недавно видел, не помню где.
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Самое плохое в подобных статьях заключаетс в том, что автор, позиционируя себя в качестве эксперта, намеренно скрывает определенные факты. Мне недавно рассказали (не знаю, насколько правда), что в культуре компании SAP весьма плохо относятся к тому, что разработчики изучают технологии вне SAP. Это, по сути, то же самое
источник

NV

Nick Volynkin in DocOps-сообщество
Наткнулся тут...

«Чтобы научиться эффективно работать в Bitrix  Framework, нужно не сравнивать то, что вы знаете по другим системам, а стараться понять как то или иное реализуется в этой системе. В плане обучения «сравнительный» подход не работает. Просто отвлекитесь от старых знаний и изучите новую систему используятолько знания PHPи сайтостроения, а не сравнивая идеологии и технологии. Легче будет освоить. А сравнивать будете потом, когда освоите Bitrix Framework.»
источник

NV

Nick Volynkin in DocOps-сообщество
Видимо, это чтобы новички не спрашивали «а почему у вас тут всё сделано так криво»
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Да, точно, это оно)
источник