Тёмная тема
- Cancel_filipp
- Постоялец
Приходится рисовать очень много схематичных картинок, с ними гораздо удобнее описывать и читается легче.
Для картинок я пользовался visio. Надо сказать, в среде ms office с ними работать приятнее, чем пытать запихнуть в web-форматы. В веб тоже хорошо, но картинки становятся тяжеловесными, выглядят хуже и для работы с ними требуются лишние телодвижения. Но все в допустимых пределах.
Confluence позволяет без труда вести документацию, которая может разрастаться на тысячи страниц - помогает древовидная навигация по документации. Также она поддерживает макросы, медиа, комментарии, цитирование, версионирование и прочее. На 10 пользователей стоит всего 10 баксов в месяц.
Туда удобно копировать графику из того же самого visio (просто копируешь фрагмент из документа visio через ctrl+c, а потом вставляешь в нужную часть документа через ctrl+v)
По опыту скажу что документацию ни кто не читает. Максимум вертикально пройдутся от мокапа к мокапу. Каждый пытается найти в ней своё - программист логику, художники графику и т. д..
Но и в этом случае ведение документации чрезвычайно полезно, так как она позволяет отвечать на вопросы членов команды цитированием по докам - член команды задаёт тебе вопрос - а ты ему ссылку на ту часть документа, где это описано.
У меня брат пилит диздоки в miro,
вот пример: https://miro.com/app/board/o9J_kwmF5og=/
zim wiki погляди вдумчиво
Я четырьмя руками за унификацию и использование универсальных инструментов везде, где это возможно. ГуглДоксов, в данном случае. И никаких специальных программ, разработанных именно для диздоков (если такие предложат) - это очень вредная затея по ряду причин. И если вам начнут продавать "особенное решение, смотрите-чё-мы-придумали-специально-для-вас" - шлите лесом.
Пользуйтесь тем, чем пользуются многие люди. При любой возможности.
В топку эти все гуглодоки, которые в любой момент могут потребовать сменить браузер на тот, в котором гугл запилил очередную нафиг ненужную какашку, тормозящую просмотр и зря греющую процессор. Для писания и вставки картинок есть либреофис - не переусложняй документ ненужными фичами и стилями оформления и будет счастье.
Этот гугл даже с гугльтранслитом облажался. Раньше нормально русский на английский и обратно переводил, а сейчас часто долго грузит перевод и кидает сообщение "ошибка перевода", и приходится несколько раз долго грузить, пока, наконец, перевод загрузится без ошибки. Он умудрился сломать то, что годами неплохо работало и не чешется. Доверяйте свои документы глюкодромщикам, это правильный путь!
А до этого гугл закрыл гуглокод, не потянул держать на своих серверах файлопомойку. Мегакорпорация!
svob
> это очень вредная затея по ряду причин.
И каков этот "ряд"?
Вполне добротным оказался https://www.gitbook.com/ это конечно не конфлюенс, но учитывая что он бесплатный, то более чем хорошо.
batarihliy
> это конечно не конфлюенс
А стоит дороже :\
У гитбука есть бесплатный план, а первый платный план у конфлюенса заметно дороже, так как сразу стартует с цены для минимум 10 пользователей. Бесплатный план гитбука выигрывает у бесплатного плана конфлюенса, потому что вроде как нет лимита на размер хранилища, 2гб для конфлюенса это очень мало.
batarihliy
У гитбука бесплатный заявлен только персональный план. Это тупо личная записанная книжка.
У конфы в бесплатном плане до 10 пользователей.
И что значит 2гб мало для Вики? Не надо в ней fhd видео хранить.
Автор оригинала в общем то искал что-то для одного редактора, но это не совсем личная записная книжка, можно создавать публично доступные документы, как пример https://docs.playcivitas.io/whitepaper/introduction
2гб это вообще ничто если честно, даже небольшое кол-во картинок в документах быстро израсходует всё место, я уж молчу о гифках по 20мб+, у меня на работе есть документы которые весят по 0.5гб+
А использовать слинкованные изображения недопустимо, потому что линки со временем умирают.
В целом конечно конфлюенс лучший вариант при платном использовании, всё остальное будет в лучшем случае полумерой.
batarihliy
> 2гб это вообще ничто если честно, даже небольшое кол-во картинок в документах
> быстро израсходует всё место, я уж молчу о гифках по 20мб+, у меня на работе
> есть документы которые весят по 0.5гб+
> А использовать слинкованные изображения недопустимо, потому что линки со
> временем умирают.
Медиконтент стоит хранить не в самой Вики, разве что кроме статичных изображений
В этой статье предлагают Obsidian.
Менеджеры заметок, BrainMap'ы, RoadMap'ы, вот это всё https://habr.com/ru/articles/735256/
P.S. Хотел отдельно определиться с редактором MarkDown для Linux 32 (Puppy),
но в силу разности решений по их установке, возможностям и использованию ещё не определился.
The Best Markdown Editor for Linux
Вроде и формат файла MD достаточно прост, но вот редакторы к нему - делают целые комбайны.
Есть и какие то варианты Online редактирования через плагины Веб браузера.
(в самих браузерах предлагаются и плагины по сохранению контента в формате MD)
KPG
>В этой статье предлагают Obsidian.
Там ещё и емакс рекламировали - отличный текстовой редактор, в который забыли положить сам редактор.
>Вроде и формат файла MD достаточно прост, но вот редакторы к нему - делают целые комбайны.
А что ты хотел, в той же статье автор восхищается возможностью писать запутанные большие документы (в которые скорее всего можно пихать html 5, который звиздец на ровном месте, не каждый браузер его хорошо тянет), а для этого нужны жирные редакторы, которые ими не подавятся, или подавятся, но не сразу. А когда жирный документ накопит много ошибок будет - ой, чего-то заглючило, спасайте информацию. Для длительного хранения информации нужен такой формат, искать в котором можно внешним поисковиком, то есть, если просто текст, то текстовые файлы, а если нужны ещё и картинки, то html 4 рулит и педалит. Плагины-хренагины, которыми там восхищаются, это вообще мина замедленного действия. Сегодня они работают, а завтра выйдет другая версия, в которой часть работать перестанет, а на них твоя работа с документом завязана. Или перелезешь в другой дистрибутив, а там с ними что-то не так.