Size: a a a

Технические писатели

2021 November 23

PZ

Pavel Zhovner in Технические писатели
Банально:

1. wysiwyg
2. Возможность публиковать наружу в интернет (не как notion)
3. Возможность вставлять сложные элементы без мучений, например как тут https://docs.flipperzero.one/ru/development/hardware
источник

PZ

Pavel Zhovner in Технические писатели
Нет визивиг
источник

M

Maeg in Технические писатели
Но дизайнер у вас отличный!
источник

PZ

Pavel Zhovner in Технические писатели
К грамматике в домене docs можно не придется, это черновики
источник

G

Grolribasi in Технические писатели
Там целый раздел, где описаны несколько генераторов.
источник

G

Grolribasi in Технические писатели
Какие ещё форматы могут быть использованы для создания статических сайтов
источник

F

Fagor in Технические писатели
1 - гавно, но есть движки с "варт ю си" и md (но это не статика)
2 - настроить, тот же гит под любую папку
3 - что есть мучения, это вопрос, несовсем понятно, что это для вас

Знаешь php js html и нужна админка "с варт ю си" установи grav с админкой на сервере. Это конечно динамика а не совсем статика, но как я помню там и статику можно забрать, в разрезе.

И вперед на yaml любые шаблоны описывай
источник

G

Grolribasi in Технические писатели
Вам однозначно нужен SSG, но стоит подумать о том, чтобы снизить планку немного. Например, убрать визивиг.
источник

M

Maeg in Технические писатели
тогда, если вы хотите немедленно публиковать контент, написанный в wysiwyg не-писателями, без редактуры, у вас эти ошибки будут торчать постоянно.
Бесплатный убийца Confluence - это любая вики-система и её хронические проблемы.
источник

PZ

Pavel Zhovner in Технические писатели
Снижать планку мне не нравится
источник

PZ

Pavel Zhovner in Технические писатели
Это не техническая проблема
источник

G

Grolribasi in Технические писатели
Ну немного. Нельзя иметь всё и сразу. Ну или готовьтесь вложиться в разработку и допиливание.
источник

AK

Alik Kurdyukov in Технические писатели
Возможно я ошибаюсь, но визивиг несет проблем больше чем решает. Визивиг очень сложно сделать не разметко-специфичным, т.е. проблемы со сменой медиа, проблемой жизненного цикла документов и т.п.
источник

NV

Nick Volynkin in Технические писатели
Привет и добро пожаловать )
источник

L

Lex in Технические писатели
Визивиг - прошлый век. Легкие языки разметки решают. Если нужны сложные элементы, то в маркдаун можно закидывать  HTML разметку.
источник

L

Lana in Технические писатели
Archbee прикольные ребята, давно за ними слежу, но мне кажется они слишком раздули скоуп задач - и убийцу ноушна, и решение для документации для разработчиков и апи в одном сделать довольно сложно, разные бизнес-задачи
источник

AK

Alik Kurdyukov in Технические писатели
Спасибо, прикольная штука
источник

AY

Alexander Yakovlev in Технические писатели
Откуда информация, что визивиг - прошлый век?)
источник

L

Lex in Технические писатели
От него много ошибок, пустых абзацев, спрятанных ссылок и прочей ерунды
источник

L

Lex in Технические писатели
А большинство редакторов визивиг позволяют править и разметку в том числе, потому что без правки разметки от артефактов не избавиться.
источник