{"Page-description":"\u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u043f\u0440\u0438\u0432\u0435\u0434\u0435\u043d\u044b \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u044b\u0435 \u043c\u0430\u0442\u0435\u0440\u0438\u0430\u043b\u044b \u043f\u043e \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u0430\u043c \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430 JavaScript \u0432 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 BroLib. \u0414\u0430\u043d\u043d\u044b\u0439 \u043c\u0430\u0442\u0435\u0440\u0438\u0430\u043b \u043e\u0442\u043d\u043e\u0441\u0438\u0442\u0441\u044f \u043a \u0442\u0438\u043f\u0443 \"\u041f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c\u0441\u043a\u043e\u0435 \u0441\u043e\u0433\u043b\u0430\u0448\u0435\u043d\u0438\u0435\". \u0418\u0437\u043b\u043e\u0436\u0435\u043d\u043d\u044b\u0435 \u0432 \u0434\u0430\u043d\u043d\u043e\u043c \u0440\u0430\u0437\u0434\u0435\u043b\u0435 \u043f\u0440\u0430\u0432\u0438\u043b\u0430 \u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u043c\u0438 \u0434\u043b\u044f \u0432\u0441\u0435\u0445 \u0441\u043f\u0435\u0446\u0438\u0430\u043b\u0438\u0441\u0442\u043e\u0432 \u043f\u043e \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u043d\u044b\u0445 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u043e\u0432 \u043d\u0430 \u044f\u0437\u044b\u043a\u0435 JavaScript \u0432 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 BroLib, \u0441\u043e\u0441\u0442\u043e\u044f\u0449\u0438\u0445 \u0432 \u0441\u043e\u043e\u0431\u0449\u0435\u0441\u0442\u0432\u0435 BroGroup.","Page-title":"\u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u044b 1.0 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u044f JavaScript \u043a\u043e\u0434\u0430 \u0432 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 BroLib","Page-unique-id":"19to_new-5","JSMessages":{"redactor":{"ajax-operation-send":"\u041f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0441\u044f \u043e\u0442\u043f\u0440\u0430\u0432\u043a\u0430 \u0434\u0430\u043d\u043d\u044b\u0445 \u043d\u0430 \u0441\u0435\u0440\u0432\u0435\u0440...","close-confirm":"\u0417\u0430\u043a\u0440\u044b\u0442\u044c \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440?","delete-confirm":"\u0412\u044b \u0436\u0435\u043b\u0430\u0435\u0442\u0435 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u0443\u0434\u0430\u043b\u0438\u0442\u044c \u0434\u0430\u043d\u043d\u0443\u044e \u0441\u0442\u0430\u0442\u044c\u044e? \u0412\u0430\u0436\u043d\u043e \u043f\u043e\u043d\u0438\u043c\u0430\u0442\u044c, \u0447\u0442\u043e \u043f\u043e\u0441\u043b\u0435 \u0443\u0434\u0430\u043b\u0435\u043d\u0438\u044f \u0441\u0442\u0430\u0442\u044c\u044e \u043d\u0435 \u0432\u043e\u0441\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c! \u041f\u0440\u043e\u0434\u043e\u043b\u0436\u0438\u0442\u044c \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044e \u0443\u0434\u0430\u043b\u0435\u043d\u0438\u044f?","input-archive-out":"\u0414\u043e\u0441\u0442\u0430\u0442\u044c \u0441\u0442\u0430\u0442\u044c\u044e \u0438\u0437 \u0430\u0440\u0445\u0438\u0432\u0430","input-archive-in":"\u041f\u043e\u043c\u0435\u0441\u0442\u0438\u0442\u044c \u0441\u0442\u0430\u0442\u044c\u044e \u0432 \u0430\u0440\u0445\u0438\u0432","send-to-server-error":"\u0412\u043e\u0437\u043d\u0438\u043a\u043b\u0430 \u043d\u0435\u043f\u0440\u0435\u0434\u0432\u0438\u0434\u0435\u043d\u043d\u0430\u044f \u043e\u0448\u0438\u0431\u043a\u0430 \u043f\u0440\u0438 \u043f\u043e\u043f\u044b\u0442\u043a\u0435 \u043e\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043b\u0435\u043d\u0438\u044f \u043f\u0435\u0440\u0435\u0434\u0430\u0447\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u043d\u0430 \u0441\u0435\u0440\u0432\u0435\u0440! \u0422\u0435\u043a\u0441\u0442 \u043e\u0448\u0438\u0431\u043a\u0438:"}}} 	
BroLib BroBlog Статья
Стандарты 1.0 написания JavaScript кода в компании BroLib

Создание нового программного продукта на языке JavaScript

При создании нового JavaScript документа необходимо использовать кодировку UTF-8 без подписи Юникода BOM. Все содержимое документа должно быть в соответствующей кодировке.

Начальный комментарий

В самом начале любого программного продукта BroLib необходимо обозначать используемые в комментариях сокращенные аннотации. Ниже приведет образец обязательного начального комментария, а также пример использования сокращённых аннотаций:
JavaScript code source
/** * Сокращенные аннотации & стандарты: http://blog.brolib.ru/articles/19.html (19 - JavaScript, 22 - PHP); * * -A, U- (c) www.brolib.com, ** https://welcome.brolib.ru/; * * -Date, Time- 2016.01.01 00:01; * -D- Программный продукт: BroGallery; */
Технология используется, в первую очередь для улучшения качества программного кода, в частности для достижения наилучшей степени понятности. При написании нового программного продукта программист обязуется внести несколько обязательных начальных комментариев (только при присутствии соответствующего кода):
  • Обязательным первым параметром всегда является ссылка на данную страницу с описанием - "Сокращенные аннотации". Данный комментарий всегда должен располагаться раньше, чем любой дальнейший аннотационный комментарий!
  • Автор программного продукта и ссылка на персональную страницу автора в системе workshop (например: workshop.brolib.ru/masters/id-1.html)
  • Версия программного продукта
  • Дата создания программного продукта
  • Назначение программного продукта
  • Возможные важные исключения
  • Другие подключаемые программные продукты, их версии, используемые методы, краткие описания целей использования данных продуктов. Ссылки на лицензию и первоисточник
  • Описание всех входящих (внешних) переменных

Общая стилистика написания JavaScript кода программных продуктов BroLib

Важно отметить, что для создания программных продуктов BROGroup активно использует jQuery. Поэтому перед написанием продукта производится подключение самой поздней на тот момент версии jQuery, серии 1 (с поддержкой I.E.6 - I.E.8).