Size: a a a

OpenStack — русскоговорящее сообщество

2020 November 06

J

J in OpenStack — русскоговорящее сообщество
Я и твой кот I.
Берёшь официальную документацию, работаешь по ней, видишь несоответствия или нехватку информации, пишешь свой вариант, отправляюсь патч, патч принимают – профит.
Ваще это все разумно и хорошо звучит, но я такое больше слышу от разработчиков.
А операторам обычно не до того, мне кажется. Очень уж много времени и сил отнимает процесс.

А в итоге получается замкнутый круг. В документацию мало вкладываются люди занимающиеся эксплуатацией, а люди занимающиеся разработкой не всегда обращают внимание на важные вещи.
источник

SA

Slava Anzhiganov in OpenStack — русскоговорящее сообщество
J
Ваще это все разумно и хорошо звучит, но я такое больше слышу от разработчиков.
А операторам обычно не до того, мне кажется. Очень уж много времени и сил отнимает процесс.

А в итоге получается замкнутый круг. В документацию мало вкладываются люди занимающиеся эксплуатацией, а люди занимающиеся разработкой не всегда обращают внимание на важные вещи.
вот да, обычно тупо нет времени писать коммиты ))
источник

ЯI

Я и твой кот I.... in OpenStack — русскоговорящее сообщество
Вы после того как разобрались, внутреннюю документацию пишете?
источник

ЯI

Я и твой кот I.... in OpenStack — русскоговорящее сообщество
Вот вместо того, чтобы писать внутреннюю документацию, сразу пишите документацию в upstream.
источник

J

J in OpenStack — русскоговорящее сообщество
Я и твой кот I.
Вот вместо того, чтобы писать внутреннюю документацию, сразу пишите документацию в upstream.
Так её не примет никто в том виде в каком она пишется.
источник

ЯI

Я и твой кот I.... in OpenStack — русскоговорящее сообщество
J
Так её не примет никто в том виде в каком она пишется.
А что не так с её видом?
источник

SA

Slava Anzhiganov in OpenStack — русскоговорящее сообщество
Я и твой кот I.
Вот вместо того, чтобы писать внутреннюю документацию, сразу пишите документацию в upstream.
"а что так можно было"))
источник

J

J in OpenStack — русскоговорящее сообщество
Я и твой кот I.
А что не так с её видом?
Вот, например, в каком стиле написано у меня:
"Если с первого раза создание виртуалки с pcie устройством зафейлилось, последующие попытки тоже будут неуспешными из-за бага в nova. Эта хренотень после первой неудачной попытки добавляет в pci requests новые запросы на устройства, не удаляя старые. Это приводит к конфликтам pcie адресов на новых хостах."
источник

SA

Slava Anzhiganov in OpenStack — русскоговорящее сообщество
Я и твой кот I.
А что не так с её видом?
например, в доке по подготовке одно написано, в некоторых сервисах необходимо отклоняться и делать другие настройки субд, иначе либо миграции не проходят, либо питон 3 ещё не работает
источник

J

J in OpenStack — русскоговорящее сообщество
Это не документация, а заметка, конечно, но такого у всех, мне кажется, очень много.
А формализацией никто не занимается.
источник

ЯI

Я и твой кот I.... in OpenStack — русскоговорящее сообщество
J
Вот, например, в каком стиле написано у меня:
"Если с первого раза создание виртуалки с pcie устройством зафейлилось, последующие попытки тоже будут неуспешными из-за бага в nova. Эта хренотень после первой неудачной попытки добавляет в pci requests новые запросы на устройства, не удаляя старые. Это приводит к конфликтам pcie адресов на новых хостах."
😅пожалуй да, стиль другой
источник

AM

Aleksey Myltsev in OpenStack — русскоговорящее сообщество
ну хз что они там задеприкейтили, глядя по ревью Postgres работает, просто какие-то отщепенцы решили его выпилить. Со своей стороны скажу что у нас Ussuri нормально на постгре живет
источник

SA

Slava Anzhiganov in OpenStack — русскоговорящее сообщество
Aleksey Myltsev
ну хз что они там задеприкейтили, глядя по ревью Postgres работает, просто какие-то отщепенцы решили его выпилить. Со своей стороны скажу что у нас Ussuri нормально на постгре живет
спасибо, попробую
источник

DT

Dmitry Tantsur in OpenStack — русскоговорящее сообщество
Ну вот так и получается, что никому не охота править доки, всем охота на них жаловаться..
источник

J

J in OpenStack — русскоговорящее сообщество
Dmitry Tantsur
Ну вот так и получается, что никому не охота править доки, всем охота на них жаловаться..
Я не жалуюсь)
источник

J

J in OpenStack — русскоговорящее сообщество
Но было бы круто, конечно, если б люди получающие деньги за работу с документацицей опенстека в редхатах, канониклах и прочих местах имели в команде аналитиков способных формализовать заметки неотесанных обезьяноподобных операторов.
источник

DT

Dmitry Tantsur in OpenStack — русскоговорящее сообщество
Было бы очень круто, если бы эти люди хотя бы контрибьютили в апстрим :(
источник

DT

Dmitry Tantsur in OpenStack — русскоговорящее сообщество
Но это уже много раз проигранная битва, по крайней мере у нас.
источник

DT

Dmitry Tantsur in OpenStack — русскоговорящее сообщество
Так что пишем сами, и не "на отъебись", а "как можем в перерывах между всем остальным" :-/
источник

DT

Dmitry Tantsur in OpenStack — русскоговорящее сообщество
И, кстати, никто, кого ты видишь в https://opendev.org/openstack/ironic/commits/branch/master/doc/source не является профессиональным пейсателем доков.
источник