Телеграмм чат группы docsascode страница 686

хотя гуглодоксы всё ещё удобнее конфлюенса, они хотя бы не так тормозят

23:22пожаловаться #1

И

так вот, какие действия нужны для того, чтобы поправить ошибку в репозе?
Открыл файл, прыгнул на нужное место, сохранил, stage/commit/push (а ещё это, при желании, автоматизируется макросами или типа того)
В гуглодоксах - мучительно ищешь нужный файл(хотя их на порядки меньше, чем файлов в репозитории), нужное место тоже приходится искать O(n) поиском

При условии, что ты смотришь на опечатку в исходниках, то в гуглдоке нужно поправить и сохранить (хотя оно автоматически сохранятся, так что одно действие). А в репозитории добавить в staging, сделать коммит, сделать пуш. При условии, что находишься в нужной ветке, иначе — действия с ветками

Но вообще я программист, а не техпис, так что работаю только с репозиториями)

23:22пожаловаться #2

И

так вот, какие действия нужны для того, чтобы поправить ошибку в репозе?
Открыл файл, прыгнул на нужное место, сохранил, stage/commit/push (а ещё это, при желании, автоматизируется макросами или типа того)
В гуглодоксах - мучительно ищешь нужный файл(хотя их на порядки меньше, чем файлов в репозитории), нужное место тоже приходится искать O(n) поиском

Ну и вообще исходное сообщение было очень утрированным и не отражает ничего)

23:23пожаловаться #3

DL

Иван

При условии, что ты смотришь на опечатку в исходниках, то в гуглдоке нужно поправить и сохранить (хотя оно автоматически сохранятся, так что одно действие). А в репозитории добавить в staging, сделать коммит, сделать пуш. При условии, что находишься в нужной ветке, иначе — действия с ветками

Но вообще я программист, а не техпис, так что работаю только с репозиториями)

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

23:23пожаловаться #4

DL

Иван

Ну и вообще исходное сообщение было очень утрированным и не отражает ничего)

а, ну оке)

23:23пожаловаться #5

DL

ну и да, YAML говно (это уже к другому тезису выше)

23:25пожаловаться #6

И

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

Предпочитаю коммитить из гуя IDE, поудобнее будет

23:25пожаловаться #7

И

ну и да, YAML говно (это уже к другому тезису выше)

+

23:25пожаловаться #8

DL

Иван

Предпочитаю коммитить из гуя IDE, поудобнее будет

у меня magit …

23:25пожаловаться #9

DL

А так, проблема большинства современных GUI - в некомпозабельности и сложности автоматизации

23:26пожаловаться #10

DL

это касается как гуглодоксов, так и большинства IDE

23:26пожаловаться #11

DL

B M

Я не холивара ради, а искренне интересуюсь. Что сейчас считается годной альтернативой yaml?

EDN

23:29пожаловаться #12

DL

YAML sucks. Contribute to cblp/yaml-sucks development by creating an account on GitHub.

Егор Доронин

Хотя, с другой стороны, как вспомню дни повсеместного распространения XML, так сразу YAML кажется великолепной альтернативой

https://github.com/cblp/yaml-sucks мде

GitHub

cblp/yaml-sucks

Нац Нац in DocOps-сообщество

23:30пожаловаться #13

НН

Скоро можно по чату собрать подборку сайтов где автор ненавидит ямл

Maksim Lapshin in DocOps-сообщество

23:31пожаловаться #14

2020 June 20

ML

Коллеги, мне все таки кажется, что концепция docs as code - это вовсе не переход от ворда к hugo, а что-то посерьезнее.

Вот как поддерживается целостность и непротиворечивость документации?

Какими усилиями поддерживается согласованность продуктового видения и документации?

Все руками?

13:42пожаловаться #15

iv

iakov v in DocOps-сообщество

да так же как и в коде — то есть руками, да

13:45пожаловаться #16

iv

iakov v in DocOps-сообщество

IMHO, попыткой как-то упорядочить смысловые единицы документов была DITA, но в целом ушла потом куда-то не туда

Maksim Lapshin in DocOps-сообщество

13:46пожаловаться #17

ML

iakov v

да так же как и в коде — то есть руками, да

Нуу, в коде есть методики проверки кодом что он целостный и адекватный

13:58пожаловаться #18

2020 June 21

RG

Ramil G in DocOps-сообщество

Maksim Lapshin

Коллеги, мне все таки кажется, что концепция docs as code - это вовсе не переход от ворда к hugo, а что-то посерьезнее.

Вот как поддерживается целостность и непротиворечивость документации?

Какими усилиями поддерживается согласованность продуктового видения и документации?

Все руками?

Да, тоже интересно. тесткейсами документацию не покроешь

10:30пожаловаться #19

BM

B M in DocOps-сообщество

Ramil G

Да, тоже интересно. тесткейсами документацию не покроешь

Спорно. Необходимо определить понятия "валидная" и "невалидная" документация и автоматизировать подобную проверку.