Size: a a a

Типичный Сисадмин (Чат)

2020 November 13

AA

Artemiy Alexandrovic... in Типичный Сисадмин (Чат)
tapo4ek
wiki хватит, прочитать главу 2 и 3 чтоб в голове созрело 4 достаточно
вот wiki прям ок, но не совсем то
а инструкции пишутся для удаленных рук на месте действия, там созревать нечему, увы
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
тебе надо писать в базу доки, затем указывать какие документы требуют объединения. В лучшем случае, если они не требует плейсхолдеров и одни накладывается под конец другого
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
брать из базы и выводить в нужном порядке - это задача не дохуя простая
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
ну по крайней мере не на столько, чтобы данный функционал в каком либо виде присутствовал в cms
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
ты можешь вхуярить как статьи и на какой-то странице в нужном порядке в шаблонизатор вывести, ага, но если это задача на 1-2 раза, то эту хуйню можно сделать и вручную
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
ты же, как я полагаю, хочешь чтобы это было в два клика около-регулярно, с различных комбинациях
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
т.е. условия со стороны клиента, запрос данных в бэке, формирование на фронте с возможностью выгрузки в какой-нибудь сасный формат, типа pdf
источник

S2

Stairway 2 Heaven in Типичный Сисадмин (Чат)
Artemiy Alexandrovich
Коллеги, наверняка кто-то задавался вопросом написания технических документаций - есть ли какая-то CMS, которая позволила бы удобно хранить и редактировать максимально декомпозированные мануалы, а также "парой кликов" объединить их в один большой документ?

Условно - есть доки по настройке ПО #1, #2, #3. Они там хранятся и актуализируются. Возникает задача настроить кластер, на котором должно быть установлено ПО #2 и #3. Создаешь инструкцию #4, где описываешь вводную часть по поднятию кластера, а потом инклюдишь туда документации #2 и #3.

И, самое важное - при изменении этих документаций они автоматически актуализирются и в инструкции #4.
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
с тем же успехом можно хоть notion использовать
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
задача-то немного другая
источник

AA

Artemiy Alexandrovic... in Типичный Сисадмин (Чат)
а чем readthedocs не канает? так вроде чет похожее судя по доке и видео
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
хз, ты либо описал не так задачу, либо я тебя нихуя не понял
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
пробуй
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
если тебе просто надо различные блоки формировать в одну статью и блоки эти просто обновлять отдельно, то канает
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
если тебе нужно генерировать комбинации на ходу различные, то не канает
источник

AA

Artemiy Alexandrovic... in Типичный Сисадмин (Чат)
на ходу нет

вот ты тупо написал пять документаций и они там лежат
раз в N месяцев ты там чот поправил, когда косяк нашел
потом прилетела задача - сделать ВОТ ЭТА
ты под ВОТ ЭТА скомпоновал магическим образом ряд уже написанных документаций, и вуаля - ничего заново писать не надо

и собственно киллер-фича - когда ты поправил что-то в исходных документациях, в скомпилированной для ВОТ ЭТАВА они автоматом актуализировались

чтоб не получилось так, что человек взял инструкцию для ВОТ ЭТАВА, а там старье, потому что-то кто-то прослоупочил и забыл перенести изменения из обновленной документации в скомпонованную

просто когда таких док 100500, и объединенных документаций тоже, то задача "не прослоупочить внести изменения во все её реинкарнации" - дофига геморная, нецелесообразная, является растратой человеческого ресурса и в конце концов много шансов протупить из-за человеческого фактора, то есть это стрельба себе в колени
источник

П

Пидорбот in Типичный Сисадмин (Чат)
Artemiy Alexandrovich
на ходу нет

вот ты тупо написал пять документаций и они там лежат
раз в N месяцев ты там чот поправил, когда косяк нашел
потом прилетела задача - сделать ВОТ ЭТА
ты под ВОТ ЭТА скомпоновал магическим образом ряд уже написанных документаций, и вуаля - ничего заново писать не надо

и собственно киллер-фича - когда ты поправил что-то в исходных документациях, в скомпилированной для ВОТ ЭТАВА они автоматом актуализировались

чтоб не получилось так, что человек взял инструкцию для ВОТ ЭТАВА, а там старье, потому что-то кто-то прослоупочил и забыл перенести изменения из обновленной документации в скомпонованную

просто когда таких док 100500, и объединенных документаций тоже, то задача "не прослоупочить внести изменения во все её реинкарнации" - дофига геморная, нецелесообразная, является растратой человеческого ресурса и в конце концов много шансов протупить из-за человеческого фактора, то есть это стрельба себе в колени
Реинкарнации для пидоров
источник

AA

Artemiy Alexandrovic... in Типичный Сисадмин (Чат)
вот!
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
Artemiy Alexandrovich
на ходу нет

вот ты тупо написал пять документаций и они там лежат
раз в N месяцев ты там чот поправил, когда косяк нашел
потом прилетела задача - сделать ВОТ ЭТА
ты под ВОТ ЭТА скомпоновал магическим образом ряд уже написанных документаций, и вуаля - ничего заново писать не надо

и собственно киллер-фича - когда ты поправил что-то в исходных документациях, в скомпилированной для ВОТ ЭТАВА они автоматом актуализировались

чтоб не получилось так, что человек взял инструкцию для ВОТ ЭТАВА, а там старье, потому что-то кто-то прослоупочил и забыл перенести изменения из обновленной документации в скомпонованную

просто когда таких док 100500, и объединенных документаций тоже, то задача "не прослоупочить внести изменения во все её реинкарнации" - дофига геморная, нецелесообразная, является растратой человеческого ресурса и в конце концов много шансов протупить из-за человеческого фактора, то есть это стрельба себе в колени
ну так можно даж гитхаб/лаб использовать c Gulp Concat
источник

j

junkym0nk3y in Типичный Сисадмин (Чат)
тогда канает кароч
источник