Size: a a a

DocOps-сообщество

2020 March 31

IC

Ivan Cheban in DocOps-сообщество
Ну, и не ноушнм единым:
https://coda.io/
источник

R

Ruslan in DocOps-сообщество
Спасибо. Ноушеном сам пользуюсь. Ради одного проекта тащить туда всех не хочется. К тому же бесплатная версия не позволяет вытащить всё разом со всей иерархией в формате пдф (
источник

IC

Ivan Cheban in DocOps-сообщество
Единственное, что они оба не бесплатные
источник

FM

Fox Mulder in DocOps-сообщество
поднимаете виртуалку, туда пихаете nginx на нем поднимаете вебсервер и через hugo+ markdown генерите вебпортал
источник

KC

Kseniya Chudakova in DocOps-сообщество
Ruslan
Всем привет!

Нашел ваш канал, а затем чатик. Спасибо, много полезной инфы. Даже очень много, я в ней заблудился. Может есть какая-то одна точка входа для нубов?

Хотелось бы попросить помощи и наставлений, что читать, что юзать, чтобы решить свою задачу.
В кратце:
- Для внутреннего пользования нужна документация одного конкретного проекта.
- Цели: упрощение входа нового сотрудника; представление всех компонент, способов и мест их развертки (облако, кастомные пользовательские устройства, смартфоны, тестовые платформы);
- Ресурсы: один человек (я), крайне малое количество времени.

Подскажите, пожалуйста, пути наименьшего сопротивления :)
Кто туда будет писать? Если люди со знанием гита — один путь, с редактором — другой
источник

R

Ruslan in DocOps-сообщество
Fox Mulder
поднимаете виртуалку, туда пихаете nginx на нем поднимаете вебсервер и через hugo+ markdown генерите вебпортал
Как-то сложно :)
источник

R

Ruslan in DocOps-сообщество
Kseniya Chudakova
Кто туда будет писать? Если люди со знанием гита — один путь, с редактором — другой
Со знанием гита, писать будут разработчики
источник

FM

Fox Mulder in DocOps-сообщество
Ruslan
Как-то сложно :)
это очень легко и быстро.
Самый быстрый и простой - гугл докс.
источник

IC

Ivan Cheban in DocOps-сообщество
Fox Mulder
это очень легко и быстро.
Самый быстрый и простой - гугл докс.
👍
источник

R

Ruslan in DocOps-сообщество
Окей, допустим с тулзой всё ясно.

Подскажите, плз, гайд или еще что-то, что поможет понять, КАК писать
источник

T

Tatiana in DocOps-сообщество
Ruslan
Окей, допустим с тулзой всё ясно.

Подскажите, плз, гайд или еще что-то, что поможет понять, КАК писать
https://developers.google.com/tech-writing/one/words можете взглянуть на гайд от гугла.
источник

iv

iakov v in DocOps-сообщество
Ruslan
Окей, допустим с тулзой всё ясно.

Подскажите, плз, гайд или еще что-то, что поможет понять, КАК писать
есть очень приятное и короткое введение Modern technical writing: http://a.co/fI895I3
источник

R

Ruslan in DocOps-сообщество
Спасибо за ссылки, пошёл смотреть
источник

IS

Igor Shakhbazyan in DocOps-сообщество
Ruslan
В том числе инструмента.

Был, нам не подошел, слишком маленькая команда, надо что-то попроще и побесплатнее :)
Лицензия Confluence на команду до 10 чел стоит $10. Для маленьких команд самое то.
источник

СИ

Степан stillru Илличевский in DocOps-сообщество
Привет неспящим. Задачка - как в pandoc написать lua-фильтр, который будет превращать конструкцию вида
 {{ code file=path/to/file }} 
в содержимое самого файла???
источник

СИ

Степан stillru Илличевский in DocOps-сообщество
Хочется md конвертить в hugo-сайт и из той же документашки делать pdf
источник

СИ

Степан stillru Илличевский in DocOps-сообщество
И при этом использовать hugo shortcodes...
источник
2020 April 01

KC

Kseniya Chudakova in DocOps-сообщество
Привет, всем! Подскажите, используете ли мониторинг для статики? Если да, то как организовали?
источник
2020 April 02

IC

Ivan Cheban in DocOps-сообщество
Kseniya Chudakova
Привет, всем! Подскажите, используете ли мониторинг для статики? Если да, то как организовали?
Привет! Вот я как раз сейчас балуюсь с мониторингом посещаемости статического сайта, сделанного на Jekyll. Мониторинг с помощью бесплатного Google Analytics. В конфигурацию сайта добавляете айдишник с гугл аналитикс. После этого можно мониторить посещаемость, устройства, с каких смотрели сайт, страны и т. д.
источник

KC

Kseniya Chudakova in DocOps-сообщество
Ivan Cheban
Привет! Вот я как раз сейчас балуюсь с мониторингом посещаемости статического сайта, сделанного на Jekyll. Мониторинг с помощью бесплатного Google Analytics. В конфигурацию сайта добавляете айдишник с гугл аналитикс. После этого можно мониторить посещаемость, устройства, с каких смотрели сайт, страны и т. д.
Привет, спасибо, что поделился! Я тоже использую Google Analytics. Но тут меня больше интересовало — отследить недоступность сервиса с алертами
источник