NV
1. Всегда актуальная документация. Документ docx автоматически не обновляется, даже из гуглдока человек может сделать себе копию и ей пользоваться.
Size: a a a
2017 November 28
NV
2. Эргономика отличная. Сайтами просто удобно пользоваться. Их удобно адаптировать к чтению на любых устройствах, от телевизора до мобильника.
NV
3. Больше инструментов. Тот же MD в вебсайт можно переделать десятком разных программ, одна лучше другой. С docx выбор меньше и для чего-то необычного наверняка придётся программировать.
NV
Самое, пожалуй, большое ограничение — права доступа. Чтобы разграничить права доступа к сайту, особенно выборочно к разным страницам, нужна работа программиста и админа.
NV
Здесь Confluence в лидерах.
NV
Заготовки документации на разных инструментах с заранее настроенной сборкой и публикацией на GitLab Pages. Отличная песочница, чтобы попробовать разработку документации как кода. https://gitlab.com/pages/
NV
@agrigorenko выше для вас ссылка. Форкните что-нибудь, попробуйте. Там всё уже настроено и сразу работает.
AG
Хорошо, спасибо, чуть-чуть попозже посмотрю.
Пока гуглодоки у нас считаются самым приемлемым вариантом)
Пока гуглодоки у нас считаются самым приемлемым вариантом)
2017 December 05
NV
Добро пожаловать )
NV
Пока тут тихо, я почти не рекламировал чат )
2017 December 09
NV
Привет, коллеги!
NV
Здесь можно задавать вопросы, хвастаться результатами и всячески обсуждать разработку документации как кода.
2017 December 12
NV
Анатолий, приветствую )
A
Всем привет.
Любитель помучать ReadTheDocs теперь с вами.
Любитель помучать ReadTheDocs теперь с вами.
NV
Предлагаю такой формат: пока что я тут несистемно накидаю вам всё, что у меня есть про версионирование документации. А на выходных уже нормальный ответ напишу.
NV
Для контекста: https://ru.stackoverflow.com/q/755543/181472
A
Спасибо большое,что откликнулись. С:
Да просто начальник дал задание ознакомится с Read The Docs.
Я чёт протупил,смотрел на .org.
На .org можно подтягивать документацию только с открытых репозиториев.
Да просто начальник дал задание ознакомится с Read The Docs.
Я чёт протупил,смотрел на .org.
На .org можно подтягивать документацию только с открытых репозиториев.
A
На .com можно подтягивать документацию с приватных.
Но конечно же за деньги.
Но конечно же за деньги.
NV
Разумеется, они ж должны на чем-то зарабатывать. У вас, видимо, приватный на гитлабе?
A
Мы готовы купить продукт у них,но чёт переговоры зашли в тупик.
Только использовать их сервак для хранения.
Нам не хочется делиться данными и чтобы мы зависимо от их сервера.
Только использовать их сервак для хранения.
Нам не хочется делиться данными и чтобы мы зависимо от их сервера.