summaryrefslogtreecommitdiff
path: root/doc/ru_RU/contributing.markdown
blob: 549170671eb3ef1272f9a4a36c94240409c2e514 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Руководство для участников проекта
==================================



Как я могу помочь проекту?[¶](#how-can-i-help "Ссылка на этот заголовок")
-------------------------------------------------------------------------



Канборд пока не идеален, поэтому есть несколько вариантов помочь проекту:



-   Присылать отзывы
-   Сообщать об ошибках
-   Добавлять или обновлять переводы
-   Улучшать документацию
-   Писать код
-   Рассказать друзьям, что Канборд отличная программа :)



Перед тем как начать большое дело, создайте новое “обсуждение вопроса” (issue) на [https://github.com/fguillot/kanboard/issues](https://github.com/fguillot/kanboard/issues) и объясните ваше предложение.



Я хочу внести предложения по проекту[¶](#i-want-to-give-feedback "Ссылка на этот заголовок")
--------------------------------------------------------------------------------------------



-   У вас есть идея по улучшению (пользовательский интерфейс или другие возможности)
-   Посмотрите в обсуждениях (issue), может ваша идея уже предложена кем-то
-   Откройте новое обсуждение (issue)
-   Опишите вашу идею
-   Вы можете проголосовать +1 за имеющиеся предложения


Я хочу сообщить об ошибке[¶](#i-want-to-report-a-bug "Ссылка на этот заголовок")
--------------------------------------------------------------------------------

-   Убедитесь, что обсуждение вопроса (issue) ранее не публиковалось
-   Откройте новую заявку (ticket)
-   Опишите, что именно не работает
-   Опишите, как воспроизвести ошибку (последовательность, как вы вышли на данную ошибку)
-   Опишите ваше окружение (версию Канборда, какая ОС, веб сервер, версию PHP, база данных и версия, хостинг провайдер)


Я хочу перевести Канборд на другой язык[¶](#i-want-to-translate-kanboard "Ссылка на этот заголовок")
----------------------------------------------------------------------------------------------------

Канборд уже переведен на несколько языков. Вы можете улучшить эти переводы. Некоторые переводы еще не завершены. Для того, чтобы сделать перевод, ознакомтесь с [руководством по переводу на другой язык](translations.markdown).


Я хочу улучшить документацию[¶](#i-want-to-improve-the-documentation "Ссылка на этот заголовок")
------------------------------------------------------------------------------------------------

-   Вы считаете, что что-то недостаточно хорошо описано, имеются грамматические или орфографические ошибки, что-то еще.
-   Документация написана в формате Markdown и хранится в каталоге `docs`{.docutils .literal}.
-   Редактируйте файлы и присылайте pull-request.
-   Документация на официальном вебсайте синхронизируется с репозиторием.


Я хочу внести свой вклад в код[¶](#i-want-to-contribute-to-the-code "Ссылка на этот заголовок")
-----------------------------------------------------------------------------------------------

Pull-requests всегда приветствуются, однако, чтобы они были приняты, вы должны следовать следующим указаниям:

-   **Перед тем как внести большое изменение или переделать дизайн, откройте новую заявку (ticket) для обсуждения.**
-   Если вы хотите добавить новую возможность, уважайте филосовию Канборда: **Мы фокусируемся на простоте**, мы не хотим иметь раздутую программу.
-   Это же относится и к пользовательскому интерфейсу: **простота и производительность**
-   Присылайте только по одному pull-request для новой возможности или исправления ошибки.
-   Небольшие pull-request легче просмотреть и быстрее влить в проект.
-   Убедитесь, что [модульные тесты выполняются успешно](tests.markdown).
-   Уважайте [стандарты кодирования](coding-standards.markdown).
-   Пишите код, который могут поддерживать другие, избегайте дублирования, используйте лучше практики PHP.

В любом случае, если вы не уверены в чем-то - открывайте новую заявку (ticket)


Рассказать друзьям, что Канборд отличная программа :)[¶](#tell-your-friends-that-kanboard-is-awesome "Ссылка на этот заголовок")
--------------------------------------------------------------------------------------------------------------------------------

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





 



[Русская документация Kanboard](http://kanboard.ru/doc/)