Skip to content

Contributing

Oscar edited this page May 23, 2020 · 1 revision

Regole di Contribuzione

Meta Regole (regole per creare regole)

Questo insieme di regole è da intendersi

  1. Flessibile: esso non deve ostacolare la collaborazione dei membri, ma renderla sinergica
  2. Moderato (o anche, pragmatico): poiché limitato è il numero dei partecipanti, tale deve essere anche il grado di sofisticazione delle regole
  3. Democratico: chiunque può apportare modifiche al documento, previa discussione con gli altri membri
  4. Provvisorio: le decisioni sulle regole di sviluppo sono soggette a variazione con l'evolversi delle conosenze sulle varie tecnologie di sviluppo

JavaScript

Completare.

Programmazione orientata agli oggetti

Rispettare i tre principi cardine della programmazione orientata agli oggetti

  1. Incapsulamento
  2. Ereditarietà
  3. Polimorfismo

Rispettare i cinque principi SOLID e pratiche annesse, in particolare

  1. Principio di singola responsabilità: una classe (ma anche e soprattutto funzioni e metodi) deve fare una e una sola cosa
  2. "Principio di interfaccia-implementazione", vedi anche Design by contract

Git

  1. Rispettare il workflow di contribuzione, che prevede:
    1. master e testing quali branch di "integrazione", e topic branch a seconda delle necessità
    2. Presenza in master di codice quanto più stabile possibile
    3. Presenza di codice altamente instabile o in fase di sperimentazione all'interno di topic branch assegnati a una feature di riferimento o all'incaricato principale
  2. Usare la lingua inglese nel log, nel README.md e in sezioni potenzialmente esposte al pubblico. Pagine riservate ai membri (come questa, o quelle dedicate agli Issues) possono essere scritte in lingua madre (italiano)