CONTRIBUTING_RU
Documentation from P8OS
Source: docs/RU/CONTRIBUTING_RU.md
Участие в проекте P8OS
Открытая когнитивная инфраструктура для автономных систем
Благодарим вас за интерес к проекту P8OS.
P8OS — открытая исследовательская и инженерная инициатива, посвящённая созданию инфраструктуры для следующего поколения автономных интеллектуальных систем.
Мы приветствуем участие разработчиков, исследователей, студентов, архитекторов, технических писателей и всех, кто разделяет цели проекта.
Философия проекта
Основные принципы P8OS:
- научный подход;
- инженерное качество;
- долгосрочная поддерживаемость;
- модульная архитектура;
- платформенная независимость;
- открытое сотрудничество.
Каждый вклад должен приносить измеримую пользу проекту.
Как можно помочь
Мы приветствуем вклад в следующих направлениях.
Архитектура
- архитектурные предложения;
- проектирование интерфейсов;
- развитие модульной структуры;
- улучшение документации.
Разработка
- Rust;
- системное программирование;
- компоненты Runtime;
- SDK;
- тестирование;
- оптимизация производительности.
Исследования
- когнитивные архитектуры;
- представление знаний;
- автономные системы;
- искусственная память;
- системы рассуждений;
- распределённый интеллект.
Документация
Документация является одной из ключевых частей проекта.
Приветствуются:
- руководства;
- диаграммы;
- пояснения;
- API-документация;
- архитектурные описания.
Перед началом работы
Рекомендуется ознакомиться со следующими документами:
- README.md
- PROJECT_OVERVIEW_RU.md
- ROADMAP.md
- CODE_OF_CONDUCT_RU.md
Понимание архитектурной концепции помогает сохранять целостность проекта.
Процесс внесения изменений
- Создайте Issue, если планируются значительные изменения.
- Обсудите предлагаемый подход.
- Реализуйте изменения.
- Создайте Pull Request.
- Примите участие в обсуждении результатов проверки.
Крупные архитектурные изменения рекомендуется обсуждать до начала реализации.
Архитектурные принципы
При разработке следует учитывать:
- простоту;
- модульность;
- сопровождаемость;
- переносимость;
- расширяемость;
- качественную документацию.
Следует избегать неоправданного усложнения решений.
Исследовательские предложения
Исследовательские материалы должны:
- чётко формулировать проблему;
- объяснять мотивацию;
- разделять подтверждённые факты и гипотезы;
- при необходимости ссылаться на существующие исследования;
- указывать возможные направления дальнейшей работы.
Принципы разработки
P8OS стремится поддерживать:
- понятный код;
- единый стиль;
- чёткие интерфейсы;
- минимальное количество внешних зависимостей;
- качественную документацию.
Подробные стандарты программирования будут опубликованы отдельно.
Платформенная независимость
P8OS создаётся как платформенно независимая инфраструктура.
По возможности следует избегать жёсткой зависимости от:
- операционных систем;
- программных фреймворков;
- облачных платформ;
- проприетарных технологий.
Платформозависимые функции рекомендуется реализовывать через абстрактные интерфейсы и адаптеры.
Интеллектуальная собственность
Передавая изменения в проект, вы подтверждаете, что:
- обладаете необходимыми правами на передаваемые материалы;
- ваши изменения не нарушают права третьих лиц;
- они могут распространяться по лицензии Apache License 2.0.
Проверка изменений
Все существенные изменения могут проходить техническое рассмотрение.
Основные критерии:
- соответствие архитектуре;
- техническая корректность;
- сопровождаемость;
- качество документации;
- долгосрочная ценность для проекта.
Цель проверки — повышение качества проекта, а не создание препятствий для участников.
Сообщество
P8OS развивается благодаря совместной работе.
Мы приветствуем:
- уважительное техническое обсуждение;
- конструктивную критику;
- альтернативные инженерные предложения;
- обмен знаниями и опытом.
Главная цель — совместное развитие проекта.
Спасибо за ваш вклад в создание инфраструктуры следующего поколения автономных интеллектуальных систем.
Команда P8OS