H
“We have so many elegant solutions to specific problems that we have new problems caused by having too many solutions.” Во истину.
Size: a a a
2019 May 12
I
У вас ссылка на статью не отвалилась?)
H
У вас ссылка на статью не отвалилась?)
Точно. Благодарю за бдительность.
D
Возвращаясь к вопросу.
Довольно-таки интересная статья, где автор поднимает насущные проблемы внутренней документации и использования различных инструментов. Очень рекомендую к прочтению.
https://medium.com/@JohnTeasdale/why-internal-technical-documentation-is-hard-8dbd3c8179c0
З.Ы. То, о чём я говорил.
Confluence is currently the best out-of-the-box option, but it doesn’t do everything. If you want it to, you’ll need a team of engineers with a specific skill to make it suit any technical use case. At that point, you should wonder if it would be cheaper in the long run to build something that runs on your own stack.
Довольно-таки интересная статья, где автор поднимает насущные проблемы внутренней документации и использования различных инструментов. Очень рекомендую к прочтению.
https://medium.com/@JohnTeasdale/why-internal-technical-documentation-is-hard-8dbd3c8179c0
З.Ы. То, о чём я говорил.
Confluence is currently the best out-of-the-box option, but it doesn’t do everything. If you want it to, you’ll need a team of engineers with a specific skill to make it suit any technical use case. At that point, you should wonder if it would be cheaper in the long run to build something that runs on your own stack.
Спасибо, почитаю. Конфля была на двух работах и на обоих бесила (возможно плохо была настроена, конечно)
H
Спасибо, почитаю. Конфля была на двух работах и на обоих бесила (возможно плохо была настроена, конечно)
H
V
Слушайте, посоветуйте бесплатный ли недорогой (конфлюэнс дорогой) движок для внутренний документации, чтобы там были:
- уровни доступа
- возможность ставить статьям тэги
- поиск по корпусу статей
- чтобы его можно было апдейтить через простой и понятный интерфейс (типа, редактор вордпресса подходит, все что требует минимальных знаний гита - уже ту мач сложно)
- желательно автоматизированные хлебные крошки
- желательно чтобы можно было прикрутить штуку типа stackoverflow, где можно задавать вопросы, давать ответы и за эти ответы голосовать
Сейчас все живет в гуглдоках, которым мы проставляем хлебные крошки и кросс-ссылки и собираем их в отдельный документ-оглавление вручную, но я уже начинаю заебываться и скоро совсем заебусь.
Пока что единственное что я придумала - это собрать сайт на вордпресс с вики-плагином и q&a плагином, но это просто потому что с вордпрессом я знакома.
- уровни доступа
- возможность ставить статьям тэги
- поиск по корпусу статей
- чтобы его можно было апдейтить через простой и понятный интерфейс (типа, редактор вордпресса подходит, все что требует минимальных знаний гита - уже ту мач сложно)
- желательно автоматизированные хлебные крошки
- желательно чтобы можно было прикрутить штуку типа stackoverflow, где можно задавать вопросы, давать ответы и за эти ответы голосовать
Сейчас все живет в гуглдоках, которым мы проставляем хлебные крошки и кросс-ссылки и собираем их в отдельный документ-оглавление вручную, но я уже начинаю заебываться и скоро совсем заебусь.
Пока что единственное что я придумала - это собрать сайт на вордпресс с вики-плагином и q&a плагином, но это просто потому что с вордпрессом я знакома.
почти всем требованиям соответсвует dockuwiki
EK
Для Google docs есть вот такая оболочка кстати https://youneedawiki.com/
О, спасибо большое за информацию, может пригодиться)
НН
Для Google docs есть вот такая оболочка кстати https://youneedawiki.com/
Спасибо
2019 May 13
НН
тэгов нет, судя по описанию
bookstack
Я надеялась notion приспособить к заметкам вместо evernote, которым я перестала пользоваться сто лет назад, потому что он кошмарно тормозил и очень навязчиво предлагал платную версию, чтобы сохранять себе статьи и т.д., но он как-то исключительно коряво их сохраняет - или в виде целой страницы, но без превьюхи, или в виде bookmark`а, но тогда без копии.
На данный момент все эти моменты отсутствуют.
Работает быстро как на ПК так и на андройде.
Попытки оплаты ненавязчивые вообще.
Сохраняет статьи лучше pocket.
Работает быстро как на ПК так и на андройде.
Попытки оплаты ненавязчивые вообще.
Сохраняет статьи лучше pocket.
NV
Что-то сразу больше минусов, чем плюсов. Неужели придётся объяснять шутку?
NV
Люблю опенсорс за дружелюбие и удобство.
2019 May 14
SB
Скорее всего это ментейнер пакета плохо сделал свою работу и забыл положить ман страницы
M
Всем бодрого! Я - Мари, помогаю devops-ребятам документировать ими нанесённые пользы))) перешла из канала @docops
FM
документировать ими нанесённые пользы - а можно перевести
H
Fox Mulder
документировать ими нанесённые пользы - а можно перевести
Действительно. Очень интересно.
OI
devops что-то делает и Мария документирует этот результат
A
Всем бодрого! Я - Мари, помогаю devops-ребятам документировать ими нанесённые пользы))) перешла из канала @docops
Таки Одессой повеяло)
2019 May 15
L
Сегодня в 12-00 закрою регистрацию на митап Write the docs в Москве, если кто-то забыл зарегаться - успевайте https://iponweb.timepad.ru/event/964116/