NV
А почему это важно? Документ слишком большой и на глаз сопоставить сложно?
Такие есть, да
О чём именно я мечтаю, так это об ассоциации этих строк комментариев со строчками в исходниках (.md, .rst и т.д.)
Size: a a a
2019 October 17
NV
Это был бы очень полезный плагин для Sphinx.
VS
А почему это важно? Документ слишком большой и на глаз сопоставить сложно?
Нет, там даже на глаз не нужно сопоставлять, если главы пронумерованы
Процесс для тех.писа наполняется рутиной, производительность падает
1. Напиши документ в редакторе X
2. Пройдись по результату от lint'а, измени исходник в редакторе X
3. Пройдись по ревью в GitLab'е, измени исходник в редакторе Х
4. Пройдись по комментариям в Google Docs, пройди по соответствующей главе измени исходник в редакторе Х
Процесс для тех.писа наполняется рутиной, производительность падает
1. Напиши документ в редакторе X
2. Пройдись по результату от lint'а, измени исходник в редакторе X
3. Пройдись по ревью в GitLab'е, измени исходник в редакторе Х
4. Пройдись по комментариям в Google Docs, пройди по соответствующей главе измени исходник в редакторе Х
NV
А как выглядел бы идеальный процесс?
VS
А как выглядел бы идеальный процесс?
Как в Word
Есть WYSIWYG абзац, на нём размечены комментарии, подсвечены строки по результату проверок от Word'а, inline предложенные исправления и т.д.
Есть WYSIWYG абзац, на нём размечены комментарии, подсвечены строки по результату проверок от Word'а, inline предложенные исправления и т.д.
NV
Чтобы даже предложенные исправления коммитить по кнопке?
VS
Лучше не коммитить, но на стейдж в рабочую копию сливать
А так да
А так да
NV
Ну да, это имеет смысл, если ревьюер активно предлагает правки.
NV
Там недавно JetBrains собирали требования к инструменту для документации на основе их IDE. Может, у них есть что-то подобное там.
НН
Текстовый редактор на джаве, что может быть интереснее
СФ
Текстовый редактор на джаве, что может быть интереснее
как будто это что-то плохое! (оглядывается на 8+ GB RAM на всех компьютерах в офисе и дома)
НН
8 это мало
НН
для жавы
СФ
это была попытка в иронию
НН
тоненько!
СФ
но вообще хочется надеяться, что парсить, раскрашивать и держать в памяти DOM маркдаун-документа должно быть полегче, чем миллиона строк в джава-проекте
НН
Надеюсь они чот порешают с этим однажды, чтоб не надо было кучу настраивать и вот это вот всё
СФ
для документации же ни статического анализа не надо, ничего такого вот
НН
можно в webstorm повырубать всё и включить md плагин, сиравно буит жрать всё
СФ
груздь-печаль