Различия между версиями 8 и 13 (по 5 версиям)
Версия 8 от 2010-07-05 15:03:16
Размер: 1816
Редактор: RostislavDzinko
Комментарий:
Версия 13 от 2010-07-06 11:15:57
Размер: 3614
Редактор: RostislavDzinko
Комментарий:
Удаления помечены так. Добавления помечены так.
Строка 11: Строка 11:
 * The source code is managed at Zope reposistory. You can checkout the trunk code like this (Anonymous access):  * Исходный код управляется через [[http://svn.zope.org/bluebream|репозиторий Zope]]. Вы можете вытянуть исходники из trunk следующим образом (анонимный доступ):
Строка 17: Строка 17:
   Вы можете стать You can also become a committer after signing a contributor agreement.  Вы можете делать изменения в репозиторий после подписания [[http://docs.zope.org/developer/becoming-a-committer.html|соглашения вкладчика]].
Строка 19: Строка 19:
 * Project blog  * [[http://bluebream.posterous.com/|Блог проекта]]
Строка 21: Строка 21:
 * The bugs and issues are tracked at launchpad.  * Баги отслеживаются на [[https://launchpad.net/bluebream|launchpad]]
Строка 23: Строка 23:
 * !BlueBream Wiki.  * [[http://wiki.zope.org/bluebream|BlueBream Wiki]]
Строка 25: Строка 25:
 * PyPI page  * [[http://pypi.python.org/pypi/bluebream|Страница PyPI]]
Строка 27: Строка 27:
 * Documentation  * [[http://bluebream.zope.org/|Documentation]]
Строка 29: Строка 29:
 * Twitter  * [[http://twitter.com/bluebream|Twitter]]
Строка 31: Строка 31:
 * Mailing list  * [[https://mail.zope.org/mailman/listinfo/bluebream|Список рассылки]]
Строка 33: Строка 33:
 * IRC Channel: #bluebream at irc.freenode.net  * IRC канал: [[http://webchat.freenode.net/?randomnick=1&channels=bluebream|#bluebream]] на irc.freenode.net
Строка 35: Строка 35:
 * Buildbot  * [[http://zope3.afpy.org/buildbot|Buildbot]]
Строка 41: Строка 41:
Процедура создания релизов, которой следует !BlueBream очень похожа на ту, которой следует ZTK.

Часть [[http://docs.zope.org/zopetoolkit/process/releasing-software.html|официального руководства по созданию релизов]] находится в файле ''CHANGES.txt''. Это важный шаг, который не может быть автоматизирован.

Другими словами, перед началом релиза убедитесь в том, что:

 * Все тесты пройдены
 * Все локальные изменения поступили в репозиторий
 * Журнал изменений (changelog) обновлен.
Строка 43: Строка 53:
 * Сделать объявление в списке рассылки
 * Сделать запись в блоге
 * Обновить статус в twitter
Строка 44: Строка 58:

Список проверки релиза на данный момент управляется через вики: http://wiki.zope.org/bluebream/ReleaseChecklist

Для разработчиков

Вклад в BlueBream

Если вы заинтересованы во внесении вклада в проект BlueBream, посетите вики страницу: http://wiki.zope.org/bluebream/ContributingToBlueBream

Ресурсы для разработчиков

  • Исходный код управляется через репозиторий Zope. Вы можете вытянуть исходники из trunk следующим образом (анонимный доступ):

       1    svn co svn://svn.zope.org/repos/main/bluebream/trunk bluebream
    

    Вы можете делать изменения в репозиторий после подписания соглашения вкладчика.

  • Блог проекта

  • Баги отслеживаются на launchpad

  • BlueBream Wiki

  • Страница PyPI

  • Documentation

  • Twitter

  • Список рассылки

  • IRC канал: #bluebream на irc.freenode.net

  • Buildbot

Процесс разработки

Создание релизов

Процедура создания релизов, которой следует BlueBream очень похожа на ту, которой следует ZTK.

Часть официального руководства по созданию релизов находится в файле CHANGES.txt. Это важный шаг, который не может быть автоматизирован.

Другими словами, перед началом релиза убедитесь в том, что:

  • Все тесты пройдены
  • Все локальные изменения поступили в репозиторий
  • Журнал изменений (changelog) обновлен.

Пострелизные шаги

  • Сделать объявление в списке рассылки
  • Сделать запись в блоге
  • Обновить статус в twitter

Список проверки релиза

Список проверки релиза на данный момент управляется через вики: http://wiki.zope.org/bluebream/ReleaseChecklist

Технические решения

Руководство по написанию документации

Обзор

Подсказки

Говорите прямо с читателем

Будьте напористым

Объясняйте ключевые идеи простыми понятиями

Предоставляйте простые примеры

Избегайте разговорных выражений

Предоставляйте ответы, не порождайте вопросы

Пересмотрите предложения, которые говорят мало, или ничего

Документации/Bluebream/BluebreamДляРазработчиков (последним исправлял пользователь RostislavDzinko 2010-07-06 14:47:47)