так это в чат технических читателей тогда

technical writer – best kind of writer!

звучит как девиз ✊ надо запомнить

Коллеги, а есть ли у вас опыт менторства или работы с ментором? Расскажите, как оно вам?

Я вот у нескольких людей учился, а сейчас думаю, что и сам могу кому-то передавать опыт. Часики тикают, так сказать ))

Привет! Поделитесь, как у вас организовано переиспользование текста. Насколько это удобно, как часто используете?
Сейчас у меня классическая схема md + движок (не очень известный в наших кругах).
Пробовала includes у Foliant, достаточно удобно.

Инклюды есть в фолианте и ещё в куче SSG. Однако, мы в Plesk их используем только для очень общих элементов — баннеры, нотификации всякие. У нас есть кое-где переиспользование текста, но лучше бы не было. Оно плохо влияет на SEO и мы думаем о том, как от этого переиспользования отказаться.

Скорее всего ещё на поисковую выборку влияют и путают пользователя

Да, всё так.

Тоже переиспользуем только различные плашки, например о тестовой функциональности

А если всё-таки надо переиспользовать что-то посерьезней плашечки с предупреждением, что делаете?

Руками копируете и потом просто внимательно следите за изменениями или всё-таки переиспользование?

Для контекста  — есть справочники с описанием методов API, и куча how-to статей где эти методы нужны. Хочется описание методов вносить только в справочники, но читать и там и там. Читателя гонять в справочник не хочется.

Аххахха, подпишусь

Неужели есть решение?

Не самоинкостылированное, а что-нить нормальное опенсурсное

дык инклюды же, просто вставка заранее определенного фрагмента текста по его айдишнику

во многих SSG реализовано

или нужно что-то более сложное?

Я как себе представлю везде инклюдить название метода или именование ИС, то аж передергивает.

И для далёких от темы, раскодируйте “SSG” плиз)

Sphinx, Gitbook, Foliant, mdBook – системы генерации многостраничных HTML-порталов из пачки md- или rst-исходников

static sites generator