rK
Началось всё с того, что я предложил перевести её в reStructuredText и генерить сайт через readthedocs, храня в гитхабе, затем предлагал самим генерить сайт через sphinx и хостить где хотят. В обоих случаях перспектива открытого хранения доки была воспринята как опасное явление, влекущее за собой опасность воровства идей, фич и так далее. Предложение не поддержалось.
Сейчас я занимаюсь созданием видеоматериалов по документации, по сути зачитываю документацию, но на фоне соответствующих разделов/окон, то есть показываю всё то, о чем говорю, и добавляю кейсы использования. И это была не моя инициатива, была задача на создания такого рода обучающих видеоматериалов от начальства. Но теперь опять же всплыла тема с опасностью распространения этих материалов, ибо я говорю давайте на ютуб зальем в плэйлист с доступом по ссылке, будем обновлять/добавлять видосы, комментарии от юзеров читать, а мне опять говорят, что на ютубе конкуренты посмотрят и украдут. В качестве площадки для распространения предложили что-то вроде stepik.org, что в моем понимании не защитит от просмотра конкурентами, но остановит от просмотра пользователями, которые не захотят ради этого регаться на непонятных площадках.
Лично я не понимаю, зачем вообще создавать документацию, если её нельзя распространять, и тем более если она в видеоформате. Сделано уже более 10 роликов в среднем по 10 минут, несколько из них уже устарели и полностью неактуальны, но и те, которыми можно пользоваться - никто не видел, лежат себе в кофлюенсе, отсмотренные только начальством)