Size: a a a

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

2019 May 10

D

Daria in DocOps-сообщество
И их расширение для хрома bookmark сохранять не умеет
источник

L

Lana in DocOps-сообщество
Для Google docs есть вот такая оболочка кстати https://youneedawiki.com/
источник

L

Lana in DocOps-сообщество
Позволяет поверх него структуру накрутить
источник

D

Daria in DocOps-сообщество
тэгов нет, судя по описанию
источник

a

arvikon in DocOps-сообщество
Может кому-то такое будет интересно - https://document360.io/
Сам не ковырял, по описанию и фичам заманчиво вроде
источник
2019 May 11

H

Hartmann in DocOps-сообщество
Daria
Слушайте, посоветуйте бесплатный ли недорогой (конфлюэнс дорогой) движок для внутренний документации, чтобы там были:

- уровни доступа
- возможность ставить статьям тэги
- поиск по корпусу статей
- чтобы его можно было апдейтить через простой и понятный интерфейс (типа, редактор вордпресса подходит, все что требует минимальных знаний гита - уже ту мач сложно)
- желательно автоматизированные хлебные крошки
- желательно чтобы можно было прикрутить штуку типа stackoverflow, где можно задавать вопросы, давать ответы и за эти ответы голосовать

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

Пока что единственное что я придумала - это собрать сайт на вордпресс с вики-плагином и q&a плагином, но это просто потому что с вордпрессом я знакома.
Так чтоб сходу всё и за недорого или (здесь должно быть возмущение) нашару... Такого нет и быть не может. Зыс ыз нат э фэйри тэйл. Зыс ыз э рил лайф йю ноу.

Два варианта:

1. Писать что-то под себя и свои задачи с нуля либо же, в качестве полумеры, брать тот же WP и пилить/накручивать его (На рубях ещё можно накрутить, поискать гемы, можно попробовать тот же Jekyll, с модификациями, соответственно.);

2. Искать вариант максимально устраивающий по большинству пунктов и чем-то жертвовать. Но оно таки будет шо-то стоить.

В любом случае, получается либо дорого по деньгам, либо затратно по времени (ну а это те же деньги).

В качестве полумеры есть масса подобных вариантов:

https://www.gitbook.com/
источник

A

Antonio in DocOps-сообщество
@alexgeorgeive gitbook в целом неплох, но, у него есть ряд болезненных ограничений, которые не дают сделать документацию по-человечески. В качестве альтернативы смотрю в сторону Vuepress
источник

H

Hartmann in DocOps-сообщество
Antonio
@alexgeorgeive gitbook в целом неплох, но, у него есть ряд болезненных ограничений, которые не дают сделать документацию по-человечески. В качестве альтернативы смотрю в сторону Vuepress
Точно! Есть такое.
На первый взгляд, довольно-таки перспективная штука.
источник

H

Hartmann in DocOps-сообщество
Он, кстати, уже вышел из беты?
источник

SB

Sergey Bronnikov in DocOps-сообщество
17 мая приглашаем на открытую лекцию Анны Гаспарян и Аллы Редько «Как писать полезные технические тексты» в Санкт-Петербурге.

Лекторы:
— Расскажут о культуре технических текстов, которые читают все.
— Ответят на вопросы: «Что такое техническая документация?», «Кто и для кого её пишет?», «Зачем придерживаться стилистических правил, отвечая на форумах?».
— Покажут разные технические тексты, а некоторые улучшат прямо на занятии.
— Поделятся практическими советами по написанию документации, ответят на вопросы.

Анна Гаспарян — тимлид технических писателей IntelliJ IDEA (JetBrains), Алла Редько — технический писатель PyCharm (JetBrains).

Вход свободный, для участия, пожалуйста, зарегистрируйтесь: https://comscicenter.timepad.ru/event/972874/.

Начало в 19:00, встречаемся по адресу: БЦ «Таймс» (ул. Кантемировская д. 2, 2 этаж).
источник

НН

Нац Нац in DocOps-сообщество
Sergey Bronnikov
17 мая приглашаем на открытую лекцию Анны Гаспарян и Аллы Редько «Как писать полезные технические тексты» в Санкт-Петербурге.

Лекторы:
— Расскажут о культуре технических текстов, которые читают все.
— Ответят на вопросы: «Что такое техническая документация?», «Кто и для кого её пишет?», «Зачем придерживаться стилистических правил, отвечая на форумах?».
— Покажут разные технические тексты, а некоторые улучшат прямо на занятии.
— Поделятся практическими советами по написанию документации, ответят на вопросы.

Анна Гаспарян — тимлид технических писателей IntelliJ IDEA (JetBrains), Алла Редько — технический писатель PyCharm (JetBrains).

Вход свободный, для участия, пожалуйста, зарегистрируйтесь: https://comscicenter.timepad.ru/event/972874/.

Начало в 19:00, встречаемся по адресу: БЦ «Таймс» (ул. Кантемировская д. 2, 2 этаж).
Классический вопрос-запись будет ?
источник

SB

Sergey Bronnikov in DocOps-сообщество
Нац Нац
Классический вопрос-запись будет ?
Я не организатор
источник

IK

Igor K. in DocOps-сообщество
Daria
Слушайте, посоветуйте бесплатный ли недорогой (конфлюэнс дорогой) движок для внутренний документации, чтобы там были:

- уровни доступа
- возможность ставить статьям тэги
- поиск по корпусу статей
- чтобы его можно было апдейтить через простой и понятный интерфейс (типа, редактор вордпресса подходит, все что требует минимальных знаний гита - уже ту мач сложно)
- желательно автоматизированные хлебные крошки
- желательно чтобы можно было прикрутить штуку типа stackoverflow, где можно задавать вопросы, давать ответы и за эти ответы голосовать

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

Пока что единственное что я придумала - это собрать сайт на вордпресс с вики-плагином и q&a плагином, но это просто потому что с вордпрессом я знакома.
Гугл драйв
источник

NV

Nick Volynkin in DocOps-сообщество
Igor K.
Гугл драйв
Так у Дарьи уже Гугл докс.
источник

FM

Fox Mulder in DocOps-сообщество
Как писать тексты и тд. Никак. Никому они не нужны правильные. Все это фикция, показуха.
источник

FM

Fox Mulder in DocOps-сообщество
Но трансляцию я бы посмотрел
источник

OI

Olga Ilchukova in DocOps-сообщество
Fox Mulder
Как писать тексты и тд. Никак. Никому они не нужны правильные. Все это фикция, показуха.
Вроде бы про правильность никто и не будет рассказыаать
источник

FM

Fox Mulder in DocOps-сообщество
Не, у jb все круто. Но они одни, а вот других большинство.)
источник

A

Artem in DocOps-сообщество
Ребят, подскажите, пожалуйста, как удалить таблицу в веб версии evernote, а то что-то я не могу разобраться)
источник

H

Hartmann in DocOps-сообщество
Daria
Слушайте, посоветуйте бесплатный ли недорогой (конфлюэнс дорогой) движок для внутренний документации, чтобы там были:

- уровни доступа
- возможность ставить статьям тэги
- поиск по корпусу статей
- чтобы его можно было апдейтить через простой и понятный интерфейс (типа, редактор вордпресса подходит, все что требует минимальных знаний гита - уже ту мач сложно)
- желательно автоматизированные хлебные крошки
- желательно чтобы можно было прикрутить штуку типа stackoverflow, где можно задавать вопросы, давать ответы и за эти ответы голосовать

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

Пока что единственное что я придумала - это собрать сайт на вордпресс с вики-плагином и q&a плагином, но это просто потому что с вордпрессом я знакома.
Возвращаясь к вопросу.
Довольно-таки интересная статья, где автор поднимает насущные проблемы внутренней документации и использования различных инструментов. Очень рекомендую к прочтению.

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.
источник