Bagikan melalui


Menampilkan dan memperbarui halaman ringkasan proyek

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Setiap proyek menyediakan ringkasan atau halaman beranda untuk berbagi informasi dan menampilkan aktivitas proyek terbaru. Halaman ini berfungsi sebagai hub pusat bagi anggota tim untuk tetap mendapatkan informasi dan terbaru tentang kemajuan proyek. Gunakan halaman ini untuk tugas-tugas berikut:

  • Bagikan pembaruan dan pengumuman proyek penting
  • Menyoroti aktivitas dan tonggak terbaru
  • Menyediakan akses cepat ke sumber daya dan dokumentasi proyek utama
  • Memfasilitasi kolaborasi dan komunikasi tim

Gunakan halaman ringkasan proyek untuk juga melakukan tugas yang lebih spesifik:

Tugas Administrator Proyek

Tugas anggota proyek

  • Menambahkan deskripsi proyek singkat
  • Pilih file README atau wiki untuk informasi proyek
  • Mengundang orang untuk berkontribusi pada proyek Anda
  • Mengatur tag proyek
  • Lihat informasi proyek
  • Melihat aktivitas proyek
  • Memfavoritkan proyek
  • Mengirim email atau memulai obrolan dengan anggota tim
  • Memulai pencarian di seluruh proyek Anda
  • Lihat informasi proyek
  • Mengirim email atau memulai obrolan dengan anggota tim
  • Melihat aktivitas proyek

Catatan

Anda dapat menunjuk proyek yang dihosting sebagai Privat atau Publik. Untuk proyek publik, pengguna anonim dapat melihat Ringkasan proyek, kecuali untuk bagian Anggota. Ikon Suka dan Favorit juga tidak terlihat oleh pengguna anonim. Untuk informasi selengkapnya, lihat Apa itu proyek publik?

Cuplikan layar halaman ringkasan.

Prasyarat

Kategori Persyaratan
Izin Anggota grup Administrator Proyek atau Edit informasi tingkat proyek izin diatur ke Izinkan melakukan tugas berikut:
- Edit informasi di halaman proyek.
- Ubah repositori yang Anda gunakan untuk berbagi informasi proyek.
- Mengelola keanggotaan proyek.
Tugas tertentu:
- Untuk mengedit halaman proyek: Kontributor ke repositori atau cabang atau izin Kontribusi diatur ke Izinkan.
- Untuk melihat ringkasan proyek: Anggota proyek yang valid.
- Untuk menambahkan atau mengedit tag proyek: Mengelola properti tingkat proyek izin diatur ke Izinkan. Izin ini mengontrol properti proyek REST API.

Tip

Jika Anda tidak memiliki izin yang diperlukan untuk mengedit halaman atau menggunakan fitur, ikon dan tautan terkait tidak terlihat oleh Anda.

Buka ringkasan proyek

Dari browser web Anda, pilih Ringkasan Gambaran Umum> Jika Anda belum memiliki proyek, buat proyek.

Jika ringkasan proyek Anda belum disiapkan, halaman selamat datang akan ditampilkan:

Cuplikan layar memperlihatkan halaman selamat datang proyek.

Pilih salah satu tugas berikut untuk memulai:

Memperbarui halaman ringkasan

Halaman ringkasan menampilkan file README yang ditentukan dalam repositori proyek atau halaman beranda wiki proyek. Untuk menggunakan beranda wiki proyek, buat wiki untuk proyek Anda dan kemudian Anda dapat mengubah halaman ringkasan proyek untuk menunjuk ke wiki.

  1. Edit halaman:

    • Jika ini pertama kalinya Anda mengedit halaman, pilih Tambahkan Deskripsi Proyek.
      Cuplikan layar halaman ringkasan, pengeditan pertama kali.

    • Jika bukan pertama kalinya Anda mengedit halaman, pilih Edit informasi proyek. Ikon ini hanya terlihat oleh anggota dengan izin untuk mengedit halaman Ringkasan proyek.

  2. Berikan deskripsi singkat tentang tujuan proyek dalam kotak Deskripsi .

    Tentang dialog proyek ini.

  3. (Opsional) Tambahkan satu atau beberapa Tag untuk proyek Anda. Tag ini mirip dengan tag item kerja. Anda dapat menambahkan beberapa tag pada satu waktu dengan menggunakan pemisah koma atau titik koma. Tag harus sesuai dengan aturan berikut:

    • Tag harus 40 karakter atau kurang
    • Tag tidak boleh berisi karakter garis miring (/) atau diakhir dengan karakter tanda hubung (-)
    • Tidak lebih dari 15 tag dapat ditambahkan ke proyek
    • Tag tidak peka huruf besar/kecil dan tidak ada tag duplikat atau tag kosong yang diizinkan.

    Catatan

    Fungsi pencarian dan filter tidak dapat digunakan untuk mencari atau memfilter tag proyek.

  4. Pilih apakah akan mereferensikan file README atau halaman beranda wiki proyek untuk konten halaman Ringkasan lainnya.

    Tip

    README default dibuat dalam repositori yang ditambahkan saat Anda membuat proyek. Anda dapat memilih README ini atau membuat repositori lain dan file README untuk tujuan ini.

    Jika Anda memilih file Readme, pilih repositori untuk README. Pratinjau teks saat ini untuk file README ditampilkan.

    Tentang dialog proyek ini, pilih, dan pilih repositori README.

    Jika Anda memilih Wiki, beranda Wiki dirujuk dan harus menjadi file pertama dalam Wiki TOC. Anda tidak dapat mengubah referensi tersebut.

  5. Untuk memperbarui konten file README atau wiki yang dirujuk, edit file yang sesuai. Untuk informasi selengkapnya, lihat Membuat README untuk repositori Anda atau Menambahkan dan mengedit halaman wiki.

    Pertimbangkan untuk menyertakan jenis informasi berikut di halaman Ringkasan Anda:

    • Cara pengguna dapat berkontribusi pada proyek Anda
    • Siapa yang harus dihubungi untuk meningkatkan izin atau menambahkan ekstensi
    • Informasi peta jalan
    • Tautan ke instruksi untuk menyiapkan lingkungan pengembangan dan pengujian mereka
    • Tautan ke instruksi untuk berkolaborasi pada kode, melacak pekerjaan, membangun alur, menyebarkan rilis
    • Tautan ke templat untuk mengajukan bug, masalah, atau permintaan
    • Tautan ke daftar distribusi untuk mengirim pertanyaan melalui email atau memposting pertanyaan di saluran Slack atau Teams.

Mengundang kontributor ke proyek Anda

Kirim email untuk mengundang pengguna untuk berkontribusi pada proyek Anda dengan memilih Undang. Untuk informasi selengkapnya, lihat Menambahkan pengguna atau grup ke tim atau proyek, Mengundang pengguna dari halaman Ringkasan.

Cuplikan layar halaman Ringkasan, tombol Undang.

Catatan

Untuk Azure DevOps Server, semua tindakan email memerlukan server SMTP untuk dikonfigurasi.

Melihat aktivitas proyek

Dari bagian Statistik proyek atau Aktivitas , Anda dapat melihat pembaruan yang dibuat untuk proyek dalam 1, 7, atau 30 hari terakhir. Pilih opsi tampilan seperti yang ditunjukkan pada gambar berikut.

Cuplikan layar halaman Ringkasan, bagian Statistik.

Mengobrol dengan anggota proyek atau mengirim email

Dari bagian Anggota , Anda dapat melihat beberapa anggota ditambahkan ke proyek, dan menyambungkannya melalui email atau obrolan dengan anggota.

Cuplikan layar halaman Ringkasan, bagian Anggota.

Catatan

100+ menunjukkan bahwa 100 anggota atau lebih ditambahkan ke proyek.

Untuk mengirim email atau memulai sesi obrolan, pilih anggota tim yang ditampilkan dan pilih opsi Anda.

Cuplikan layar halaman Ringkasan, bagian Anggota, opsi yang tersedia untuk menyambungkan ke anggota tim.

Catatan

Untuk Azure DevOps lokal, semua tindakan email memerlukan server SMTP untuk dikonfigurasi.

Mencari proyek

Dari halaman Ringkasan , Anda dapat memulai pencarian kode, item kerja, dan wiki Anda. Untuk informasi selengkapnya, lihat Mulai menggunakan pencarian.

Cuplikan layar halaman Ringkasan, kotak pencarian.

Menginisialisasi file README untuk repositori Git

Anda dapat berbagi proyek dan tujuan Anda, dan cara bagi anggota tim untuk berkontribusi pada proyek melalui file README proyek. Untuk proyek Git, file README.md harus berada di akar setiap repositori di cabang default. Untuk proyek berbasis Git, panel kiri mendukung navigasi ke repositori lain. File Halaman Selamat Datang/README.md terpisah dapat dibuat untuk setiap repositori.

  1. Buka > Repos. Halaman ini memandu Anda untuk memulai dengan cepat dengan menambahkan kode ke repositori Saat Anda memilih salah satu opsi untuk mengkloning, mendorong, mengimpor, atau menginisialisasi repositori.

  2. Dengan kotak centang Tambahkan README dicentang, pilih Inisialisasi.

    Cuplikan layar Inisialisasi file README, versi terbaru

    File README default ditambahkan ke repositori proyek, dalam hal ini, repositori Uji Fabrikam.

  3. Kembali ke Ringkasan Gambaran Umum>dan pilih file README untuk halaman proyek. Pilih Edit.

    Cuplikan layar Pilih file README.

  4. Pilih repositori proyek tempat Anda menginisialisasi file README.

    Cuplikan layar Pilih Repositori tempat file README berada.

  5. Untuk mengedit file README, pilih tautan file README.

    Cuplikan layar Edit file README.

    Anda diarahkan ke > Reposuntuk file README. Anda dapat mengedit dan memodifikasi file README Markdown seperti yang Anda lakukan pada file lain di repositori Git. Anda dapat menggunakan bahasa Markdown untuk memformat file README dan menambahkan gambar. Untuk informasi selengkapnya, lihat Membuat README untuk panduan repositori dan Markdown Anda.

Menginisialisasi file README untuk repositori TFVC

Untuk proyek yang memilih TFVC untuk kontrol versi, file README.md harus berada di akar folder proyek tim Anda, misalnya, $/TeamProject/README.md.

  1. Buka File Repos>.

  2. Pilih Tambahkan Deskripsi Proyek.

    Cuplikan layar halaman Selamat Datang, proyek baru TFVC, buat readme.

  3. Pilih repositori TFVC dan pilih Simpan. Jika tidak ada file README yang ada di repositori, Anda akan melihat pesan berikut.

    Cuplikan layar dialog Tentang proyek ini.

  4. Untuk membuat file README, pilih Repos>File dan pilih file baru untuk menambahkan file ke repositori proyek.

  5. Beri nama file sebagai README.md.

    Cuplikan layar dialog Tambahkan file baru.

  6. Tambahkan konten file README Anda dalam format Markdown, lalu pilih Check in....

    Cuplikan layar Masukkan konten file README.

  7. Pilih Check in untuk menyelesaikan proses check-in file README.

    Cuplikan layar dialog file README Check-in.

  8. Pilih > Gambaran Umumuntuk meninjau halaman ringkasan proyek Anda dengan file README ditampilkan.

    Cuplikan layar halaman ringkasan Proyek dengan file README ditampilkan.

REST API