GitHub è una piattaforma collaborativa
Come accennato in precedenza, la collaborazione è alla base di tutto ciò che fa GitHub.
Sono stati usciti i repository nella prima unità del modulo e si è appreso che i repository consentono di organizzare il progetto e i relativi file.
L'ultima unità è stata illustrata sulle richieste pull, un modo per tenere traccia delle modifiche apportate al progetto.
In questa unità vengono illustrati i problemi e le discussioni, altri due elementi che contribuiscono alla natura collaborativa della piattaforma GitHub Enterprise.
Problemi
Sono stati creati problemi di GitHub per tenere traccia di idee, feedback, attività o bug per il lavoro su GitHub.
I problemi possono essere creati in vari modi, in modo da poter scegliere il metodo più pratico per il flusso di lavoro.
Per la procedura dettagliata nella parte successiva, verrà illustrato come creare un problema da un repository, ma è sufficiente sapere che esistono una miriade di modi. Ecco un elenco di tutti i modi da cui è possibile creare problemi.
I diversi modi per creare un problema da:
- un repository
- un elemento in un elenco di attività
- una nota in un progetto
- un commento in un problema o in una richiesta pull
- una riga di codice specifica
- o una query URL
Creazione di un problema da un repository
In GitHub.com passare alla pagina principale del repository.
Sotto il nome del repository selezionare Problemi.
Selezionare Nuovo problema.
Se il repository usa modelli di problema, accanto al tipo di problema che si vuole aprire, selezionare Inizia.
Se il tipo di problema che si vuole aprire non è incluso nelle opzioni disponibili, selezionare Apri un problema vuoto.
Nel campo Aggiungi un titolo immettere un titolo per il problema.
Nel campo Aggiungi una descrizione digitare una descrizione del problema.
Se si è un operatore di manutenzione del progetto, è possibile assegnare il problema a un utente, aggiungerlo a una bacheca del progetto, associarlo a un'attività cardine o applicare un'etichetta.
Al termine, selezionare Invia nuovo problema.
Alcune conversazioni sono più adatte per le discussioni su GitHub.
È possibile usare Le discussioni di GitHub per porre e rispondere a domande, condividere informazioni, fare annunci e condurre o partecipare a conversazioni su un progetto.
Nella sezione successiva verranno esaminate discussioni e come usare al meglio la funzionalità.
Discussioni
Le discussioni sono relative alle conversazioni che devono essere accessibili a tutti e non sono correlate al codice. Le discussioni consentono una conversazione fluida e aperta in un forum pubblico.
In questa sezione si procederà:
- Abilitazione di una discussione nel repository
- Creazione di una nuova discussione e varie categorie di discussione
Si esaminerà ora l'abilitazione di una discussione nel repository.
Abilitazione di una discussione nel repository
I proprietari di repository e gli utenti con accesso in scrittura possono abilitare Le discussioni di GitHub per una community nei repository pubblici e privati. La visibilità di una discussione viene ereditata dal repository in cui viene creata la discussione.
Quando si abilita per la prima volta GitHub Discussioni, si viene invitati a configurare un post di benvenuto.
In GitHub.com passare alla pagina principale del repository.
Sotto il nome del repository selezionare Settings.
Scorrere verso il basso fino alla sezione Funzionalità e in Discussioni selezionare Impostazioni discussioni.
In Inizia una nuova discussione modificare il modello per allinearlo alle risorse e al tono che si vuole impostare per la community.
Selezionare Avvia discussione.
È ora possibile creare una nuova discussione.
Creare una nuova discussione
Qualsiasi utente autenticato che può visualizzare il repository può creare una discussione in tale repository.
Analogamente, poiché le discussioni dell'organizzazione si basano su un repository di origine, qualsiasi utente autenticato che può visualizzare il repository di origine può creare una discussione in tale organizzazione.
In GitHub.com passare alla pagina principale del repository o dell'organizzazione in cui si vuole avviare una discussione.
In nome del repository o dell'organizzazione selezionare Discussioni.
Sul lato destro della pagina selezionare Nuova discussione.
Selezionare una categoria di discussione selezionando Inizia. Tutte le discussioni devono essere create in una categoria. Per le discussioni sui repository, gli utenti con autorizzazioni di manutenzione o amministratore per il repository definiscono le categorie per le discussioni in tale repository.
Ogni categoria deve avere un nome univoco e un'associazione di emoji e una descrizione dettagliata che ne indica lo scopo. Le categorie aiutano i gestori a organizzare il modo in cui le conversazioni vengono archiviate e sono personalizzabili per distinguere le categorie che sono domande e risposte o più conversazioni aperte. La tabella seguente illustra le categorie predefinite per le discussioni e il relativo scopo.
Categoria | Scopo | Formato |
---|---|---|
📣 Annunci | Aggiornamenti e notizie dei gestori del progetto | Annuncio |
#️⃣ Generale | Tutto ciò che riguarda il progetto | Discussione aperta |
💡 Idee | Idee per cambiare o migliorare il progetto | Discussione aperta |
🗳️ Sondaggi | Sondaggi con più opzioni per la community per votare e discutere | Sondaggi |
🙏 Domande e risposte | Domande per la community a cui rispondere, con un formato di domanda/risposta | Domande e risposte |
🙌 Mostra e racconta | Creazioni, esperimenti o test rilevanti per il progetto | Discussione aperta |
In Titolo discussione immettere un titolo per la discussione e in Scrivi immettere il corpo della discussione.
Selezionare Avvia discussione.
In questo modo GitHub ispira la collaborazione. A questo punto è possibile passare a come gestire le notifiche, sottoscrivere i thread e iniziare a usare le pagine di GitHub.