Розділи

Запит на вдосконалення функціоналу


Список ЗНФ

ЗНФ - це стисло задокументоване пояснення як нова функція повинна працювати та як її реалізувати, викладене таким чином, щоб ключові та інші розробники Phalcon однозначно зрозуміли вашу пропозицію, та змогли її втілити.

ЗНФ містить:

  • Пропонований синтаксис
  • Запропоновані імена класів і методи
  • Опис особливостей використання
  • Яку користь це принесе спільноті та фреймворку
  • Якщо ця функція вже впроваджена в інших фреймворках, тоді надати коротке пояснення того, як це було реалізовано і його переваги

Запит на вдосконалення функціоналу буде відхилено , якщо:

  • Функція робить фреймворк повільним
  • Функція не створює додаткової цінності (переваг) фреймворку
  • ЗНФ незрозумілий, неякісна документація, незрозуміле пояснення тощо.
  • ЗНФ не обговорювався з командою чи не має голосів на підтримку від спільноти
  • ЗНФ не відповідає стратегії розвитку/філософії фреймворка
  • ЗНФ негативно вплине/поламає продукти, розроблені на базі актуальної чи попередніх версій фреймворка
  • З автором ЗНФ відсутній зворотній зв’язок/реакція на запитання чи уточнення з боку спільноти і розробників
  • Технічно неможливо це реалізувати
  • Він може бути використаний тільки в стадіях розробки/тестування
  • Представлені/запропоновані класи/компоненти не відповідають Принципу однозначної відповідальності
  • Використовує статичні методи - (не дозволено)

Щоб надіслати ЗНФ вам не потрібно надавати готовий код у Zephir або C, або розробляти готову функцію завчасно. Запити на новий функціонал покликані пояснити мету такої реалізації та ініціювати дискусію про те, як найкраще реалізувати такий функціонал.

Всі ЗНФ мають бути додані в якості нової проблеми на GitHub. Будь ласка, не забувайте використовувати префікс [NFR] у назві вашого запиту.