Guida ai contributi di FinOps Toolkit

Benvenuto nel toolkit FinOps. Come iniziativa open source, il nostro successo dipende dallo sforzo collettivo della comunità. I contributi svolgono un ruolo fondamentale nel migliorare ed espandere le capacità del toolkit, rendendolo più prezioso ed efficace per tutti.

Esistono diversi modi per contribuire al toolkit FinOps:

• Lavorare sui bug esistenti: è possibile facilitare l'identificazione e la risoluzione dei bug esistenti elencati nel repository.
• Fornire suggerimenti per nuove funzionalità o miglioramenti: se non si ha familiarità con la codifica, è comunque possibile contribuire suggerendo nuove funzionalità o miglioramenti per gli strumenti.
• Proporre un nuovo strumento: se è stato sviluppato uno strumento correlato a FinOps e si vuole che faccia parte del toolkit FinOps, è possibile inviare una proposta per prendere in considerazione.
• Esaminare le richieste pull: le revisioni del codice sono un aspetto fondamentale della gestione della qualità del codice e della garanzia dell'affidabilità e delle funzionalità del progetto. Esaminando le richieste pull esistenti suggerite dai membri della community, è possibile contribuire in modo significativo al successo del progetto senza necessariamente creare nuovo codice.
• Domande di risposta: essere attivamente coinvolti nella risposta alle domande e fornire assistenza ai membri della community è un contributo prezioso al progetto.
• Aggiornare la documentazione: la documentazione funge da risorsa cruciale per utenti, sviluppatori e collaboratori. Microsoft si impegna a mantenere la documentazione accurata, completa e aggiornata. È essenziale per il successo del toolkit.

Apprezziamo l'interesse per contribuire al toolkit FinOps.

Vuoi rimanere connesso al team? Partecipa alla nostra riunione settimanale dei collaboratori il mercoledì alle 17:00 ora del Pacifico / 1:00 UTC o all'orario di ufficio bisettimanale alle 17:30 ora del Pacifico / 1:30 UTC.

Lavorare sui bug esistenti

Se si è desiderosi di contribuire ma non si sa dove iniziare, un ottimo punto di partenza è esaminare l'elenco dei commenti e suggerimenti esistenti. Identificare quindi i problemi che si allineano alle proprie competenze e interessi.

1. Esaminare l'elenco dei problemi esistenti.
2. Assegnare se stessi al bug su cui si vuole lavorare.

Se stai leggendo questo articolo per la prima volta e stai lavorando al repository del toolkit FinOps, assicurati di esaminare il nostro wiki Per iniziare.

Come fornire il proprio contributo

Il progetto del toolkit FinOps offre diversi modi per contribuire, sia che si sia uno sviluppatore, un professionista di FinOps o un appassionato di cloud. Le sezioni seguenti illustrano i modi in cui è possibile partecipare.

Inviare un nuovo problema

Se si ha un nuovo suggerimento di funzionalità, è stato identificato un bug o si hanno idee per migliorare gli strumenti esistenti, è consigliabile inviare un problema. I commenti e suggerimenti ci aiutano a garantire che il toolkit soddisfi le esigenze degli utenti. E se sei disposto a fare un passo avanti e contribuire all'implementazione dei tuoi suggerimenti, ti diamo il benvenuto ai tuoi contributi.

A questo scopo, effettuare i seguenti passaggi:

1. Passare all'elenco dei problemi e selezionare Nuovo problema.
2. Scegliere l'opzione che descrive meglio il contributo (correzione di bug, richiesta di modifica o richiesta di funzionalità).
3. Selezionare Disposto a correggere nella parte inferiore della pagina.
4. Inviare il problema.

Proporre un nuovo strumento

Se è stato sviluppato uno strumento correlato a FinOps e si vuole che faccia parte del toolkit FinOps, passare all'elenco dei problemi, selezionare Nuovo problema e selezionare l'opzione Proporre un nuovo strumento . Includere il maggior numero possibile di informazioni sullo strumento e su come può trarre vantaggio dalla community di FinOps.

Il consiglio di amministrazione di FinOps toolkit esamina la proposta e contatta l'utente per ulteriori discussioni.

Revisionare le richieste pull

Controllare l'elenco delle richieste pull aperte e fornire feedback costruttivo sulle modifiche al codice proposte dai membri della community. Assicurarsi che il codice rispetti le linee guida di codifica, sia ben documentato e segua le procedure consigliate.

Offrire suggerimenti per migliorare la qualità del codice, ad esempio ottimizzare le prestazioni, migliorare la leggibilità e risolvere potenziali casi limite o bug.

Per assicurarsi che funzionino come previsto, testare la funzionalità delle modifiche al codice proposte nel pull request. Implica l'esecuzione di test, la verifica dei casi limite e il controllo di eventuali effetti collaterali imprevisti.

Quando possibile, provare a suggerire modifiche al codice usando Aggiungi un suggerimento per semplificare il processo di revisione.

Rispondere alle domande

Essere attivamente coinvolti nella risposta alle domande e fornire assistenza ai membri della community è un contributo prezioso al progetto.

• Condividi conoscenze: usa le tue competenze ed esperienza per fornire risposte utili e informative alle domande generate dai membri della community. Offrire spiegazioni chiare, esempi e riferimenti per supportare le risposte.
• Assistenza per la risoluzione dei problemi: aiutare i membri della community a risolvere i problemi tecnici o a risolvere i problemi di configurazione riscontrati durante l'uso del toolkit.

Aggiornare la documentazione

• Identificare le aree per il miglioramento: esaminare la documentazione esistente per identificare eventuali informazioni, imprecisioni o lacune obsolete da risolvere.
• Migliorare chiarezza e coerenza: chiarire le sezioni ambigue, riorganizzare il contenuto per una struttura migliore e garantire coerenza nella terminologia, formattazione e stile in tutta la documentazione.
• Aggiorna contenuto: aggiorna le informazioni obsolete, aggiungi nuovo contenuto per coprire le funzionalità o le modifiche recenti e rimuovi le sezioni obsolete che non sono più rilevanti.

Grazie.

I contributi all'open source, grandi o piccoli, rendono possibili progetti come questo. Grazie per aver preso il tempo necessario per contribuire.

Codice di comportamento di Microsoft per l'open source

Questo progetto ha adottato il codice di comportamento microsoft open source.

Per altre informazioni, vedere Domande frequenti sul codice di comportamento oppure scrivere a opencode@microsoft.com per qualsiasi altro commento o domanda.