Правила в разделе авторского кода

Обсуждение сайта и форума yiiframework.ru
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

2zelenin, вы меня очень улыбныли, спасибо вам за это огромное. Думаю, дальнейшее общение с вами бессмысленно. Кому надо - тот знает мой уровень, а вам, особенно, пожелаю подрасти хотя бы до тимлида, а там глядишь и с людьми общаться научитесь. Поэтому что это явно не ваша сильная черта характера. А если хотите померяться навыками, то вперед - пишите тему в курилку, думаю всех позабавит ваш код. :) А если нет, то желаю вам удачи.
P.S.: В случае общения не по теме - буду выдавать предупреждения. Уже без уговоров.
zelenin
Сообщения: 10596
Зарегистрирован: 2013.04.20, 11:30

Re: Правила в разделе авторского кода

Сообщение zelenin »

Ekstazi писал(а):2zelenin, вы меня очень улыбныли, спасибо вам за это огромное. Думаю, дальнейшее общение с вами бессмысленно. Кому надо - тот знает мой уровень, а вам, особенно, пожелаю подрасти хотя бы до тимлида, а там глядишь и с людьми общаться научитесь. Поэтому что это явно не ваша сильная черта характера. А если хотите померяться навыками, то вперед - пишите тему в курилку, думаю всех позабавит ваш код. :) А если нет, то желаю вам удачи.
P.S.: В случае общения не по теме - буду выдавать предупреждения. Уже без уговоров.
для кого вы все это пишите? В теме отписалось 5 человек приблизительно, по делу - пара. Если со мной общение бессмысленно, то с кем вы тут разговаривать будете? Мне небезразлично. Другим начхать.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

Для вас, например ;) И не берите на себя смелость говорить за всех. Теме быть так как в ней есть необходимость.
zelenin
Сообщения: 10596
Зарегистрирован: 2013.04.20, 11:30

Re: Правила в разделе авторского кода

Сообщение zelenin »

ну так вот мое мнение: чек-лист должен отсекать все самое плохое, заставляя по минимальным позициям соответствовать нынешним реалиям. Поэтому необходимы обязательные пункты. Никто не будет проверять качество кода - нужно хотя бы соответствовать минимальным требованиям, вписываясь в экосистему.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение samdark »

1. readme.md в котором написано что делает код и как его использовать.
2. github.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

Готово viewtopic.php?f=9&t=19281 Написал как смог, жду критики и замечаний.
P.S.: Два дня писал.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение samdark »

Отредактировал. В основном, поправил форматирование и формулировки. Вроде ничего по сути не выкинул.
mickgeek
Сообщения: 957
Зарегистрирован: 2014.05.31, 20:50
Откуда: Санкт-Петербург
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение mickgeek »

Хорошая работа. Можно ещё добавить некое замечание, что если в расширении используются сообщения для вывода, то желательно внедрить механизм интернационализации.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

2Sam, Спасибо, действительно, так намного лучше! Вот что значит своя книга ;)
2mickgeek, Добавил в соответствии со стилистикой, показанной Александром.
mickgeek
Сообщения: 957
Зарегистрирован: 2014.05.31, 20:50
Откуда: Санкт-Петербург
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение mickgeek »

Ekstazi писал(а):2mickgeek, Добавил в соответствии со стилистикой, показанной Александром.
Отлично! Правда, с нумерацией небольшая путаница возникла :)
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

Поправил
Аватара пользователя
xoma
Сообщения: 641
Зарегистрирован: 2009.04.02, 15:24
Откуда: Ногинск
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение xoma »

По своему опыту я бы еще добавил две вещи:

1 ROADMAP.md - файлик с планами по дальнейшему развитию библиотеки/модуля, аналогично CHANGELOG.md файлик "живой" - дополняется и корректируется по ходу.
2 Очень рекомендовал бы избегать ситуации как на приложенной картинке. Лично для себя завел правило - каждый релиз (бета, RC и т.д.) - не более 30 записей в CHANGELOG.
Нет никаких проблем сделать v0.1-beta-1 v0.1-beta-2 и т.д. Зато пользователю будет проще переходить от версии к версии и он не погрязнет в километровом CHANGELOG
Вложения
Milestones   yiisoft yii2.png
Milestones yiisoft yii2.png (15.29 КБ) 11569 просмотров
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение samdark »

Пока ничего не получается с этим сделать. И да, это не очень хорошо...
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Правила в разделе авторского кода

Сообщение Ekstazi »

2xoma, ROADMAP.md не для всего актуален. Надо будет подумать, если еще кто-то поддержит, то добавлю.
Ответить