NV
Да, в HTML, который гитбук показывает
Size: a a a
2019 September 18
ДС
Уже завтра гляну, сейчас в дороге
a
Привет! Есть у кого-нибудь опыт работы с gitbook? Возник вопрос по якорям в тексте. В файле .md сделал оглавление, к заголовкам прикрутил ссылки все стандартно: в оглавлении
В репозитории все норм отрабатывает, а раскатали в gitbook - не аллё 🤔
[header](#header) , у самого заголовка ссылка <a name="header"></a> В репозитории все норм отрабатывает, а раскатали в gitbook - не аллё 🤔
В html5 атрибут name не поддерживается. Только id. Может в этом соль?
ДС
В html5 атрибут name не поддерживается. Только id. Может в этом соль?
Возможно, надо почитать
2019 September 19
NK
Сообщество Write the Docs на TeamLeadConf SPb.
Впереди TeamLeadConf SPb! Пока что я отдыхаю от конференций (т.е. просто работаю), а мои коллеги по сообществу Write the Docs придут. Приходите к ним на стенд с вашими вопросами про документацию.
Если хотите что-то обсудить заранее, приходите с вопросами в чат @docsascode.
Стенд будет выглядеть вот так:
Впереди TeamLeadConf SPb! Пока что я отдыхаю от конференций (т.е. просто работаю), а мои коллеги по сообществу Write the Docs придут. Приходите к ним на стенд с вашими вопросами про документацию.
Если хотите что-то обсудить заранее, приходите с вопросами в чат @docsascode.
Стенд будет выглядеть вот так:
2019 September 20
АП
Один из участников WTD Prague написал статейку своих мысле о DocsAsCode https://document360.io/blog/docs-like-code-is-it-worth-the-hassle/
АП
Один из участников WTD Prague написал статейку своих мысле о DocsAsCode https://document360.io/blog/docs-like-code-is-it-worth-the-hassle/
Очень комерческим пост оказался IMHO
АП
Ну да каждый пиарится как может )
VS
Автор противопоставил документацию коду, приведя в пример зависимость от стилей и статики
VS
...но это же буквально как фронтенд устроен
ИУ
Один из участников WTD Prague написал статейку своих мысле о DocsAsCode https://document360.io/blog/docs-like-code-is-it-worth-the-hassle/
"I was shoking" (c). Да ладно =)
ИУ
Напомнило классику, вот тут та же суть
НН
>Written by Saravana Kumar
>Saravana Kumar is the Founder/CEO of Document360
>Индус
>Saravana Kumar is the Founder/CEO of Document360
>Индус
RK
в статье прекрасно всё, можно сразу читать summary, закрывать ноутбук и идти пить какао на подоконнике
NV
Это напомнило мне одно описание курса по разработке документации. Сверстанное убого, как будто в Ворде. Хостилось на Битриксе.
NV
Недавно видел, не помню где.
NP
Самое плохое в подобных статьях заключаетс в том, что автор, позиционируя себя в качестве эксперта, намеренно скрывает определенные факты. Мне недавно рассказали (не знаю, насколько правда), что в культуре компании SAP весьма плохо относятся к тому, что разработчики изучают технологии вне SAP. Это, по сути, то же самое
NV
Наткнулся тут...
«Чтобы научиться эффективно работать в Bitrix Framework, нужно не сравнивать то, что вы знаете по другим системам, а стараться понять как то или иное реализуется в этой системе. В плане обучения «сравнительный» подход не работает. Просто отвлекитесь от старых знаний и изучите новую систему используятолько знания PHPи сайтостроения, а не сравнивая идеологии и технологии. Легче будет освоить. А сравнивать будете потом, когда освоите Bitrix Framework.»
«Чтобы научиться эффективно работать в Bitrix Framework, нужно не сравнивать то, что вы знаете по другим системам, а стараться понять как то или иное реализуется в этой системе. В плане обучения «сравнительный» подход не работает. Просто отвлекитесь от старых знаний и изучите новую систему используятолько знания PHPи сайтостроения, а не сравнивая идеологии и технологии. Легче будет освоить. А сравнивать будете потом, когда освоите Bitrix Framework.»
NV
Видимо, это чтобы новички не спрашивали «а почему у вас тут всё сделано так криво»
NP
Да, точно, это оно)