Для модулей на маркетплейс было бы хорошо заложить отдельное поле "Ссылка на документацию" или что то подобное. Как это есть с демо и также вывести для нее отдельную красивую кнопочку.

Как в примере во вложении:

Приветствую, коллеги!

Доработайте, пожалуйста API - добавьте более сложную фильтрацию товаров - по стандартным полям инфоблока и свойствам.

Хотелось бы писать функционал опираясь на официальную документацию. Добавьте, пожалуйста ее для этого API.

В конце страницы урока, например:

http://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2803

Есть ссылка "Развернуть комментарии" - которая показывается даже если комментариев нет.
Это запутывает - чтобы узнать, есть ли комментарии, нужно щёлкнуть по этой ссылке.

Нужно добавить однозначное сообщение (например, "Комментариев пока нет") о том, что комментарии отсутствуют. И ссылку для разворачивания комментариев в этом случае не показывать.

Идея разрешить и поощрять пользователей создавать документацию.
Сейчас, чтобы почитать по d7 нужно читать курсы, потом еще гуглить сайт, форум/блоги.
Из-за этого много информации которую ищешь, просто не читаешь. А это сильно тормозит саморазвитие и увеличение навыков.

Если весь опыт будет в одном месте, уверен это очень сильно всем поможет.

Чтобы пользователи размещали именно в документацию, нужно их стимулировать бонусами.
Размещение информации - премодерируемое.

Создать свод правил по которым нужно размещать документацию.
В документации  создать перелинковку с курсами.  

Добрый день, разработчики (и особенно Роберт)!

Не нашел описание класса CUserOptions, разобраться можно только по исходникам. Функционал не так часто встречаемый, тем не менее нужный для разработки собственных продуктов.

Добавьте, поожалуйста!

Было бы неплохо расширить разделы документации и курсов.
Допустим есть функционал, не суть важно насколько он новый, но в документации нет детального описания работы с ним и его настройки, нет подробного описания его возможностей и ограничений.
Пример из свежего..
CRM + 1С: есть только инструкция по подключению и запись в блоге что возможно сделать при данной интеграции, но всё описано довольно поверхностно. Без нюансов и деталей с которыми часто можно столкнуться, и многие, очень многие заваливают вопросами отдел поддержки или пишут вопросы в блог, спрашивают друг друга..  
К сожалению, даже по прошествии многих месяцев нет возможности открыть документацию и прочесть пусть собранную по крупицам но столь полезную информацию. Партнерам приходится вести собственную документацию по продуктам Битрикса, клиентам задавать вопросы направо и налево.. и порой ждать ответа месяцами.
Возможно даже партнерам стоит поделится подобной информацией что бы Битрикс свел это в одно целое. Как думаете?

Добрый вечер, разработчики Битрикс!

Напишите более детальную документацию по модулю Блог и его компонентам, плохо документирован.

На официальном сайте 1С-Битрикс уже давно висит заметка о правилах написания исходного кода.
http://dev.1c-bitrix.ru/docs/php_recommendation.php
Будем откровенны - следуют им далеко не все программисты. Не раз видел такой сайт-чудище Франкенштейна - сколько программистов - столько и стилей расставления {}, отступов и наименований.

Как же заставить всех следовать правилам? Мои идеи:
1) Ввести в монитор качества тест, который проверял бы оформление всего php-кода в папках local, bitrix/templates, bitrix/php_interface. Хочешь-не хочешь, а люди начнут вспоминать про существование этих правил.
2) В маркетплейсе ввести аналогичную проверку для загружаемых решений. По результату проверки либо совсем запрещать публикацию модуля, либо как-то визуально выделять в маркетплейсе такие решения. Например, если решение прошло проверку на оформление кода, добавлять бейджик "100% следование стандарту" (метод пряника) или наоборот. (метод кнута).

Давайте будем честными, Битрикс не пользуется популярностью на европейском рынке, о таком слове вообще никто не слышал, все знают что такое Друпал, Жумла и Вордпрес, а про Битиркс не слышали.

Хотя по качеству исполнения и по возможностям Битрикс на две головы выше. Хоть в 8-ой версии Друпала и добавили ООП и современные шаблонизаторы, но ядро D7 и ORM все равно оставляют Битиркс лидером по удобству для разработчика, а юзабилити, интерфейс и удобство использования у Битрикса вообще вне конкуренции.

Но все равно, о нем никто не знает, все боятся на ней работать, и дело даже не столкьо в незнании системы, а может даже скорее в том, что система росийская. Ввиду последних событий - сложно представить способ которым можно заставить европейцев использовать российский продукт.

Для чего это нужно:
1. платежеспособность европейских клиентов на порядок выше;
2. легко освоить рынок сайтостроения с помощью более качественной CMS;
3. устойчивость и уверенность в завтрашнем дне для программистов и партнеров.

Все знают, что маркетинговый отдел Битрикс творит чудеса, 10% от общего бюджета, который тратит Битрикс, способен легко переплюнуть рекламные активности других CMS. Просто почему-то такая задача не ставится и никаких действий не прозводится.

Что можно сделать:
1. перевести документацию на английский, чтобы привлечь англоязычных разработчиков;
2. перенести часть производства в другие страны (Германия, Польша, Украина);
3. проводить маркетинговую активность на европейском рынке (спонсорство, выставки, реклама);
4. ввести статус "Англоговорящий партнер" для тех кто хочет работать с европейцами и знает английский.

Для примера, сравните документацию для разработчиков на русском языке:
http://dev.1c-bitrix.ru/api_help/
и на английском: http://www.bitrixsoft.com/help/

похоже что на нее (английскую документацию) просто забили, а это как раз одна из основ, почему европейцы боятся осваивать Битрикс, в нем ничего не понятно. Для перевода документации вполне можно привлечь битрикс-сообщество, уверен, у многих хороший технический английский.

Сделать нормальную английскую демо-версию, чтобы любой мог зайти и попробовать ее, а не так как сейчас, заполнить форму, и только тогда может-быть вышлют ссылку на скачивание: http://www.bitrix.de/download/cms/

Часть производства (например, разработку Битрикс24, или разработку управления сайтом) перенести в другие страны, привлечь иностранных разработчиков для работы над системой. Чтобы не было репутации чисто-российской разработки, а была больше ориентированной на запад.

Дублировать перевод блогов от Битрикс на английский (сейчас много полезных нововведений разработчики Битрикс пишут прямо в блогах, какой новый функционал, что он умеет), и все это недоступно англоговорящим разработчикам, если нанять переводчика и просто дублировать текст блогов на английский - было бы намного круче. Сейчас же на английской версии сайта мертвым висят новости за 2011 год на главной странице.

В целом выигрывают космополиты, которые могут охватить весь рынок интернета, а не только узкую его часть. К тому же, качество CMS Битиркс на сегодня намного превышает западные аналоги, нужно только захотеть и сделать, все возможно.

Это в том числе заинтересует новых разработчиков писать под Битрикс, так как они будут видеть перспективы развития и выхода на другие рынки.

Было бы здорово иметь возможность кастомизировать новый визуальный редактор.

Вероятно базовые настройки можно было бы задавать как и раньше - в настройках модуля, а более гибкие параметры можно передавать с помощью массива настроек, как это сделано в том же TinyMCE.

Также очень не хватает хотя бы базовых настроек и описания API нового виз. редактора.

Так будет легче изучать недокументированные возможности,  порой это очень нужно

В идеале хотелось бы увидеть диаграмму последовательности действий при работе с ценобразованием, а в особенности в каком порядке и какие события вызываются.

Метод косвенно описан в описании метода CDatabase::Insert:
Хотелось бы подробностей

Сегодня столкнулся с неприятной ситуацией, когда после очередного "стабильного" обновления перестал работать код:

Как оказалось, теперь поле FORUM_ID не является допустимым для использования в фильтре, однако в документации это не отражено, в результате чего пришлось изучать исходный код в поисках причины пропавшей работоспособности.

Ранее об этом уже упоминалось, но хочется еще раз поднять вопрос о том, что бы для обновлений был максимально подробный changelog, что бы было понятно заранее к чему готовится. Кроме этого, я бы предпочел, и думаю, что я не один такой буду, кто был бы готов подождать обновлений, но зато что все изменения были задокументированы.

Необходима методика измерения "времени загрузки" до и после внедрения технологии Композит (то, что в рекламе уменьшилось в 100 раз).

• Методика должна быть обоснована (именно то что в презентации описывается в презентации и на http://www.1c-bitrix.ru/composite/, в понятных пользователю терминах, чтобы можно было сравнить с увиденным на экране)
• Методика должна быть доступна к реализации простому пользователю (описаны инструменты, где их взять, как настроить, как использовать)
• Методика должна быть проиллюстрирована примерами на которых наблюдается заявленное Х100 ускорение сайта.
  

Сейчас абсолютно не ясно какая из цифр может считаться искомой.


Конкретное пособие по измерению, а не общие слова и теоретические выкладки. Теорию мы усвоили. Нужен практикум.

Например для следующих методов:
Было бы очень полезно видеть ключи массива прямо в справке!
А то сейчас приходится исполнять код и смотреть какие ключи есть в результирующем массиве, что не всегда удобно и всегда занимает времени больше, чем могло бы быть.

Порой добавляется интересная возможность, а в документации это лишь пара строчек  в середине текста.
Например SECTION_SCOPE в CIBlockElement::GetList.
В принципе это есть в описаниях обновлений, но как часто их читают?
Хорошо бы иметь changelog для страниц документации api. Тогда сразу видны новые возможности.

Предлагаю на основе модуля  Живое описание АПИ сделать автоматический (или хотя бы автоматизированный) апдейт документации.

Я понимаю, что "человеческие" (написанные человеком) описания функций/событий появляются не быстро, но можно было бы хотя бы создать о них заметки.
Преимущества:
- их уже можно будет начинать комментировать, а комментарии бывают ценнее, чем даже  "человеческое" описание.
- по ним будет работать централизованный поиск.
- по ним будет работать внешний поиск (Яндекс/Гугл), в котором зачастую легче найти информацию, чем в штатном поиске.

Если бы попутно отмечалось бы с какой по какую версию существует та или иная функция/событие, то было бы еще лучше.

Модули Битрикса имеют очень много настроек. Эти настройки не всегда очевидны. Установка того или иного значения не известно к чему приведёт, какой результат будет получен от включения или изменения настройки. Почему бы рядом с настройкой на поставить хинт, подсказку, с описанием этой настройки. Этот хинт можно залинковать на отдельную страницу, где будет официальная документация от Битрикса к настройке (написанная простым понятным языком), а также комментарии пользователей (в том числе приёмы использования, не стандартное использование и т.д.). Трачу значительное количество времени на поиск документации к настройке, а если не нахожу её, то приходится обращаться в ТП. Мне кажется это было бы очень удобно!