GitHub adalah platform kolaboratif

  • 8 menit

Kolaborasi adalah inti dari semua yang dilakukan GitHub. Kami pergi ke repositori di unit pertama modul dan mempelajari bahwa repositori membantu Anda mengatur proyek anda dan file-filenya. Di unit terakhir, kami belajar tentang permintaan pull, yang merupakan cara untuk melacak perubahan yang dilakukan pada proyek Anda.

Di unit ini, kita belajar tentang masalah dan diskusi. Ini adalah fitur yang berkontribusi pada sifat kolaboratif GitHub Enterprise Platform.

Terbitan

Masalah GitHub digunakan untuk melacak ide, umpan balik, tugas, atau bug untuk bekerja di GitHub. Masalah dapat dibuat dengan berbagai cara, sehingga Anda dapat memilih metode yang paling nyaman untuk alur kerja Anda.

Panduan ini mencakup cara membuat masalah dari repositori. Masalah juga dapat dibuat dari:

  • Item dalam daftar tugas.
  • Catatan dalam proyek.
  • Komentar dalam masalah atau permintaan pull.
  • Baris kode tertentu.
  • Kueri URL.

Membuat masalah dari repositori

  1. Di GitHub.com, buka halaman utama repositori.

  2. Di bawah nama repositori Anda, pilih Masalah.

    Cuplikan layar memperlihatkan bagian atas halaman utama repositori dengan bagian Masalah disorot.

  3. Pilih Masalah baru.

  4. Jika repositori Anda menggunakan templat masalah, di samping jenis masalah yang ingin Anda buka pilih Mulai.

    Jika jenis masalah yang ingin Anda buka tidak disertakan dalam opsi yang tersedia, pilih Buka masalah kosong. Jika tidak menggunakan templat, lewati ke Langkah 5.

    Jika repositori Anda menggunakan formulir masalah, Anda akan melihat formulir terstruktur untuk diisi alih-alih templat masalah kosong. Formulir masalah memungkinkan pemeliharaan untuk mengumpulkan informasi tertentu dalam format standar.

    Cuplikan layar menu templat masalah, dengan opsi Buka masalah kosong disorot.

  5. Di bidang Tambahkan judul , masukkan judul untuk masalah Anda.

  6. Di bidang Tambahkan deskripsi , ketik deskripsi masalah Anda.

  7. Jika Anda adalah manajer proyek, Anda dapat menetapkan masalah kepada seseorang, menambahkannya ke papan proyek, mengaitkannya dengan tonggak pencapaian, atau menerapkan label.

  8. Setelah selesai, pilih Kirim masalah baru.

Gunakan label, sebutan, dan reaksi untuk mengelola kolaborasi secara efektif dan meningkatkan visibilitas masalah. Templat masalah membantu mempertahankan struktur dan harapan yang konsisten untuk kontributor.

Beberapa percakapan mungkin lebih sesuai untuk Diskusi GitHub. Gunakan Diskusi GitHub untuk mengajukan dan menjawab pertanyaan, berbagi informasi, membuat pengumuman, dan melakukan atau berpartisipasi dalam percakapan tentang proyek.

Di bagian berikutnya, kami akan meninjau Diskusi dan cara terbaik menggunakan fitur ini.

Diskusi

Diskusi dirancang untuk percakapan yang belum tentu terkait dengan kode—seperti Tanya Jawab Umum, ide, atau umpan balik umum. Mereka mendukung komunikasi terbuka yang sedang berlangsung dalam forum bersama dan dapat bersifat publik atau privat, tergantung pada visibilitas repositori.

Dalam bagian ini, Anda akan mempelajari bagaimana:

  • Mengaktifkan diskusi di repositori Anda.
  • Membuat diskusi baru dan berbagai kategori diskusi.

Mari kita selaraskan untuk mengaktifkan diskusi di repositori Anda.

Mengaktifkan diskusi di repositori Anda

Pemilik repositori dan mereka yang memiliki akses Tulis dapat mengaktifkan Diskusi GitHub untuk komunitas di repositori publik dan privat mereka. Visibilitas diskusi mewarisi visibilitas dari repositori tempat diskusi dibuat.

Saat pertama kali mengaktifkan Diskusi GitHub, Anda diminta untuk mengonfigurasi postingan selamat datang.

  1. Di GitHub.com, buka halaman utama repositori.

  2. Di bawah nama repositori Anda, pilih Pengaturan.

    Cuplikan layar bagian atas halaman utama repositori dengan bagian Pengaturan disorot.

  3. Gulir ke bawah ke bagian Fitur dan di bawah Diskusi, pilih Diskusi penyiapan.

    Cuplikan layar kotak Diskusi dengan tombol Penyiapan diskusi hijau disorot.

  4. Di bawah Mulai diskusi baru, edit templat agar sesuai dengan nada dan sumber daya komunitas Anda.

  5. Pilih Mulai diskusi.

Anda sekarang siap untuk membuat diskusi baru.

Membuat diskusi baru

Setiap pengguna terautentikasi yang dapat melihat repositori dapat membuat diskusi di repositori tersebut. Untuk diskusi tingkat organisasi, setiap pengguna yang dapat melihat repositori sumber juga dapat membuat diskusi.

  1. Pada GitHub.com, navigasikan ke halaman utama repositori atau organisasi tempat Anda ingin memulai diskusi.

  2. Di bawah repositori atau nama organisasi Anda, pilih Diskusi.

    Cuplikan layar bagian atas halaman utama repositori dengan bagian Diskusi disorot.

  3. Di sisi kanan halaman, pilih Diskusi baru.

  4. Pilih kategori diskusi dengan memilih Mulai. Semua diskusi harus ditempatkan dalam kategori. Pelaksana repositori menentukan kategori ini.

    Cuplikan layar pilihan menu pilih kategori diskusi, dengan opsi atas Pengumuman dan tombol mulai disorot.

Setiap kategori diskusi mencakup nama, emoji, dan deskripsi unik untuk mengklarifikasi tujuannya. Kategori membantu pengelola mengatur cara percakapan diajukan. Mereka dapat disesuaikan untuk membantu membedakan kategori yang merupakan percakapan tanya jawab atau lebih terbuka. Tabel berikut ini memperlihatkan kategori default untuk diskusi dan tujuannya.

Kategori Maksud Format
📣 Pengumuman Pembaruan dan berita dari manajer proyek Pengumuman
#️⃣ Umum Apa saja dan segala sesuatu yang relevan dengan proyek Diskusi terbuka
💡 Ide Ide untuk mengubah atau meningkatkan proyek Diskusi terbuka
🗳️ Polling Jajak pendapat dengan beberapa opsi bagi komunitas untuk memilih dan mendiskusikan Jajak pendapat
🙏 Tanya Jawab Umum Pertanyaan bagi komunitas untuk dijawab, dengan format pertanyaan/jawaban Pertanyaan dan Jawaban
🙌 Tampilkan dan beri tahu Pembuatan, eksperimen, atau pengujian yang relevan dengan proyek Diskusi terbuka

Pengurus repositori dapat menyematkan diskusi penting ke bagian atas tab Diskusi untuk visibilitas yang lebih baik.

  1. Di bawah Judul diskusi masukkan judul untuk diskusi Anda, dan di bawah Tulis masukkan isi diskusi Anda.

    Cuplikan layar memulai halaman diskusi baru dengan kotak Judul diskusi dan kotak konten kosong.

  2. Pilih Mulai diskusi.

Itu mencakup bagaimana GitHub mendukung kolaborasi melalui Masalah dan Diskusi. Sekarang mari kita pindah ke bagaimana Anda dapat mengelola pemberitahuan, berlangganan utas, dan mulai menggunakan halaman GitHub.

Menandai komentar sebagai jawaban

Dalam diskusi gaya Tanya Jawab, Anda dapat menandai komentar sebagai jawaban yang diterima untuk pertanyaan asli.

  1. Navigasi ke diskusi.
  2. Temukan komentar yang paling tepat menjawab pertanyaan asli.
  3. Pilih Tandai sebagai jawaban di bawah komentar.

Komentar akan disorot, sehingga memudahkan orang lain untuk menemukan solusi dengan cepat. Anda juga dapat membatalkan tanda jawaban jika diperlukan.

Mengonversi diskusi menjadi masalah

Jika diskusi mengarah ke pekerjaan yang perlu dilacak, Anda dapat mengonversi diskusi menjadi masalah.

  1. Navigasi ke diskusi yang ingin Anda konversi.
  2. ... Pilih menu (tiga titik) di kanan atas diskusi.
  3. Pilih Konversi ke masalah.
  4. Konfirmasi konversi dan pilih repositori untuk membuat masalah baru.

Ini melacak pekerjaan yang dapat ditindakkan yang berasal dari percakapan komunitas.

Menyematkan diskusi

Anda dapat menyematkan diskusi penting ke bagian atas halaman Diskusi untuk visibilitas yang lebih baik.

  1. Navigasi ke diskusi yang ingin Anda sematkan.
  2. ... Pilih menu (tiga titik) di kanan atas diskusi.
  3. Pilih Sematkan diskusi.

Diskusi yang disematkan sangat membantu untuk menyoroti pengumuman, pertanyaan penting, atau topik yang sedang berlangsung yang harus diperhatikan komunitas.