Выпуск документации был следующим:
[spoiler]
Курс Администратор Бизнес
Создано:
- Существенно обновлён и дополнен раздел
Удачи всем нам!
|
Разработчикам |
Обновление документации в августе 2017
25.08.201715:4525.08.2017 15:45:38
Выпуск документации был следующим:
[spoiler]
Курс Администратор Бизнес
Создано:
Удачи всем нам!
К примеру документацию выложить на гитхаб (там ничего секретного вроде нет), и дать разработчикам редактировать делая пулл реквесты?
P.S. Да я знаю что у вас есть формочка ниже и комменты, но в нее влом что-то писать, речь о том чтобы дать сообществу более удобный как для сообщества, так и для вас инструмент чтобы улучшать документацию.
Грубо говоря как это делают для OpenSource движков
Да, вы закрытый продукт, но это же всего лишь доки. А создав акк на github вы расположите к себе сообщество.
Сколько существует Битрикс столько же у него отсутствует нормальная документация.
2. Пройдитесь по гитхабу и репозиторию композера с тегом битрикса)
Вы увидите множество энтузиастов которые пишут "Свои стандарты разработки на битриксе" и "Типовые решения задач на битриксе", просто потому что текущий формат документации закрытый, развивается очень медленно, далек от требований сообщества.
Формат GitHub - это максимально удобный и знакомый для большинства разработчиков мира формат)
Писать в комментах это анонимно, нет признания коллег. Работа по сути в закрытую только с представителем битрикса.
Писать в сообществе совсем другое дело, каждая мысль фильтруется не только вами, но и всем сообществом, в итоге получается гораздо бОльшее качество. Заслуги всех кто вкладывается видны перед сообществом.
Во всяком случае я считаю что попробовать точно стоит, а если сомневаетесь - сделайте голосовалку с вопросом:
"Где бы вам было удобнее помогать развивать документацию Битрикс?"
а) Github
б) В комментах к текущей документации
в) Мне это не интересно
Хотя мне кажется что распределение ответов для любого разработчика очевидно, почти никто не выберет формат комментов)
А еще Bitrix получит реально большой плюс в карму от разработчиков, это 100% =)
Битрикс - коммерческий проект. Официальная документация - это то, за что мы несём ответственность. Если в результате неточности в доке кто-то попадёт на деньги и предъявит это Битриксу, мы отвечаем.
Кто будет отвечать за "освящённый" Битриксом в гитхабе код? Я не в состоянии проверять всё, что там напишут. Разработчики Битрикса тем более не будут этого делать. Понятно, что деньгами за ошибки там никто не заставит отвечать нашу компанию, но репутационные потери... Как с ними быть? Кто будет в случае форс-мажора разбираться что это не наши примеры кода? Все скажут: Битрикс дырявый. И поедет по миру очередной миф.
Давно уже у Битрикса нет проблем с производительностью, но до сих пор встречаются такие мнения.
Вот банально, когда создается у вас внутри задача на разработчика который должен написать документацию на очередной D7 класс с примерами, вместо того чтобы писать с нуля - разработчику зайти, взять наработки или внеся корректировки взять уже готовое.
2. Если вы не знакомы с гитхабом, то там опубликовано будет только то, что вы проверили и согласовали. Т.е. писать можно сколько угодно, в любом случае публиковаться будет только те пул-реквесты которые вы заапрувите.
3. Если вы так боитесь за примеры кода - то вы можете помечать их каким нибудь флагом вроде "Битрикс не несет ответственности" как помечаете сейчас комментарии.
Но поверьте, модерация в т.ч. по безопасности кода обычно в сообществе гораздо сильнее чем вашими внутренними усилиями. Говнокод или дырявый обычно сразу шапками закидают.
В отличии от комментариев сейчас, там хоть не будет ДИКОГО КОДА в примерах, который встречаешь в 9/10 проектах скопипащеных из комментариев, на которые и дизлайка поставить нельзя.
Т.е. никаких потерь, только профит.
Также это прямая коммуникация с сообществом, просто проверьте 10 правок в месяц для начала, которые набрали больше всего голосов. Именно то что больше всего нужно сообществу, сообщество само решит проголосовав за них. Это не превратиться в тысячное сообщество) Будут по началу несколько десятков (в лучшем случае!) энтузиастов которые захотят сделать полезное для сообщество дело и помочь Вам с документацией.
А на счет репутационных потерь, такой шаг как раз бы сделал шаг на встречу сообществу и его требованиям, помог бы немного отбелить то что очернено прилично за много лет. Реально большой плюс в карму, можно еще пиар отдел свой подключить, заголовок "Битрикс создает аккаунт на gihub" станет на месяц одним из самых читаемым после публикации.