Project WordPress

Halaman ini berisi detail project penulisan teknis yang diterima untuk Google Season Dokumen.

Ringkasan proyek

Organisasi open source:
WordPress
Penulis teknis:
dmivelli
Nama proyek:
Tingkatkan Visibilitas Artikel di Dokumentasi HelpHub WordPress
Durasi proyek:
Durasi standar (3 bulan)

Project description

Ringkasan Eksekutif

Popularitas WordPress tumbuh dalam hitungan menit. Pada awal Juli 2020, WordPress 5.4 (versi terbaru yang dirilis pada 21 Maret 2020) telah diunduh hampir 51 juta kali. Bahasa yang paling umum digunakan adalah bahasa Inggris (71%), diikuti oleh Spanyol (4,7), dan Indonesia (2,4).

Dokumentasi teknis yang hebat adalah tulang punggung dari setiap sistem bantuan. Penulis teknis berpengalaman mengolah pengetahuan menjadi konten bagi pengguna. Pengguna ingin melakukan beberapa tindakan yang bernilai bagi atau diperlukan dari mereka pada saat itu. Penulis teknis yang baik memahami bahwa dokumentasi yang ditulis dengan baik, akurat, dan kemampuan untuk menempatkan diri mereka dalam pikiran pengguna adalah hal yang sangat penting. Namun, hal yang paling penting bagi penulis teknis, seperti kualitas produksi dan editorial, mungkin tidak begitu penting bagi pengguna dibandingkan ketepatan waktu dan visibilitas. Apa manfaat topik bantuan yang ditulis dengan indah jika pengguna tidak dapat menemukannya?

Sejak diluncurkan pada tahun 2003, pertumbuhan WordPress di arena Open Source telah menarik minat developer, pengguna, dan kontributor. Kategori dan tag artikel asli perlu diperbarui dan dimodernisasi untuk mengikuti pertumbuhan dan perubahan kebutuhan komunitas WordPress.

Ketika jalur pengguna ke dokumentasi yang diminta membingungkan atau terganggu, mereka gagal dalam penelusuran, kehilangan kepercayaan pada produk, dan mungkin akan membuangnya.

Ada solusinya. Berikut adalah cara untuk meningkatkan visibilitas dan mendukung jalur pengguna ke dokumentasi yang diharapkan:

  1. Menentukan dan menetapkan gaya untuk judul kategori
  2. Evaluasi judul kategori dan pastikan judul tersebut membahas topik dengan benar (mengusulkan pembaruan, jika perlu)
  3. Tinjau artikel dan pastikan kategorisasinya sudah benar
  4. Tentukan subkategori untuk setiap artikel
  5. Pastikan tidak ada hasil penelusuran yang memandu pengguna untuk mendukung forum
  6. Mencatat topik duplikat atau yang sudah tidak berlaku untuk dihapus

Komunitas WordPress telah menyelesaikan pekerjaan luar biasa dan berbagi dalam pencapaian selama 17 tahun terakhir. Memperbarui kategorisasi dan memastikan perjalanan pengguna yang akurat akan terus meningkatkan pertumbuhan, kesuksesan, dan loyalitas pengguna yang membuat hampir 70 juta postingan baru dan 77 juta komentar baru setiap bulan.

Pengantar

Penulis Joseph Campbell menciptakan istilah tersebut, Perjalanan Pahlawan. Dalam fiksi, hal ini mengacu pada konsep struktural di mana tokoh protagonis melakukan perjalanan ke dunia, menghadapi dan mengatasi tantangan, dan kembali bertransformasi.

Di ranah dokumentasi teknis, pengguna juga memulai perjalanan – yang membawa mereka ke topik bantuan dengan tujuan pembelajaran, mendapatkan jawaban, dan pemecahan masalah. Ketika pengguna dapat melakukan ini, semua akan baik-baik saja. Ketika pengguna tidak dapat menemukan jawaban, mereka membuat mereka frustrasi dan kecewa.

Tetapi, mengapa hal ini terjadi? Hal itu bukan karena penulis melakukan kesalahan, tidak peduli, atau tidak memiliki pengetahuan. Sering kali, penulis teknis tidak mempertimbangkan perjalanan pengguna. Penulis mungkin terlalu larut dalam membuat konten yang bagus tetapi tidak memikirkan bagaimana pengguna akan mengakses topik tersebut. Berfokus pada {i>user journey<i} sangatlah penting. Kita harus mempertimbangkan apa yang ingin mereka ketahui dan bagaimana mereka ingin sampai di sana.

Saya berbicara dengan Konsultan WordPress dan Desainer UX Estela Rueda, yang memberikan beberapa sejarah. Saat ini, beberapa judul tidak mendeskripsikan konten artikel dengan benar. Kategori digunakan sebagai tag dan karena dibuat 15 tahun yang lalu, beberapa kategori tersebut sudah tidak berlaku. Pemberian tag tidak konsisten. Hal ini menimbulkan hambatan bagi pengguna yang mencari jawaban.

Status Saat Ini

Dukungan WordPress dibagi menjadi sembilan kategori utama (Memulai, Menginstal WordPress, Penggunaan Dasar, Administrasi Dasar, Penyesuaian, Pemeliharaan, Keamanan, Topik Lanjutan, Pemecahan Masalah). Setiap kategori berisi beberapa sub-kategori atau sub-topik yang mengarah ke artikel dengan kemungkinan lebih banyak lagi di setiap halaman landing.

Manfaat memiliki kontributor WordPress yang antusias dan kolaboratif adalah tersedianya banyak topik. Namun, dengan banyak suara dan sudut pandang, pemberian tag dan kategori menjadi tidak konsisten.

Topik-topik ini memerlukan modernisasi untuk memastikan bahwa kategori tersebut memenuhi kebutuhan pengguna WordPress saat ini. Dengan lebih dari 200 artikel, masalah terkait tag dan kategorisasi menjadi relevan.

Analisis Rencana

Tujuan utamanya adalah meninjau dan mengklasifikasikan ulang artikel agar lebih mudah ditelusuri. Kami mengusulkan langkah-langkah berikut:

  1. Bekerja sama dengan Mentor Estela Rueda untuk memperkuat proses

    • Ini adalah langkah penting untuk memastikan detail dikonfirmasi dan disepakati
    • Menurut Estela, kami akan melacak semua pembaruan yang diusulkan di spreadsheet (pengalaman Estela menunjukkan bahwa sebaiknya mengumpulkan lalu mengusulkan rekomendasi)

  2. Menentukan dan menetapkan gaya untuk judul kategori

    • Saya menyarankan struktur yang seragam dan konsisten untuk kategori dalam masa kini alih-alih bentuk gerund (Instal vs. menginstal), karena bentuk gerund (-ing) dapat menimbulkan kesulitan bagi pengguna Bahasa Inggris sebagai Bahasa Kedua (ESL) dan -ing tidak menambah nilai bagi pengguna
    • Beberapa kategori terdiri dari subjek yang terdiri dari satu dan dua kata (seperti Pemeliharaan, Keamanan, Administrasi Dasar) dan beberapa lainnya berupa frasa bergerund (Memulai dengan WordPress, Menyesuaikan) – masuk akal untuk membahas cara membuat struktur yang konsisten
    • Saya telah meneliti bagaimana organisasi lain menyiapkan bantuan online mereka dan akan mendiskusikannya dengan mentor saya untuk melihat apa yang mungkin berguna

  3. Mengevaluasi judul kategori (dan mengusulkan pembaruan)

    • Hal ini harus dapat dikenali oleh perspektif audiens target WordPress dan memenuhi kebutuhan mereka saat ini
    • Pastikan semuanya konsisten dan mematuhi standar Panduan Gaya WordPress
    • Pastikan judul menyampaikan/menjelaskan maksud
    • Judul harus menjelaskan tindakan prasyarat atau status pengguna/perangkat yang diperlukan

  4. Meninjau artikel/topik

    • Apakah topiknya secara akurat memenuhi kebutuhan pengguna target audiens WordPress?
    • Apakah topik menetapkan konteks yang benar atau merupakan bagian dari urutan yang lebih besar?
    • Apakah langkah-langkah tersebut membedakan berbagai pelaku dalam tugas (pengguna, sistem/perangkat, siapa yang melakukan apa)?
    • Apakah para aktornya dibedakan dengan jelas?
    • Apakah langkah-langkah tersebut memecah proses yang kompleks menjadi potongan-potongan yang dapat ditindaklanjuti?

  5. Menentukan dan memberi tag pada subkategori

    • Lihat cerita pengguna dan terus tambahkan ke {i>spreadsheet<i} untuk referensi di masa mendatang
    • Terus tambahkan ke daftar subkategori dan berikan detail jalurnya

  6. Pastikan tidak ada hasil penelusuran yang menautkan pengguna ke forum dukungan

  7. Catat topik duplikat atau usang untuk penghapusan; pekerjaan forensik ini akan membantu menginformasikan dan merampingkan perjalanan pengguna

Rentang waktu

Hingga 16 Agustus 2020

  • Lanjutkan peninjauan dokumentasi WordPress
  • Memahami gaya dokumentasi WordPress lebih dalam
  • Meneliti praktik terbaik untuk perjalanan pelanggan ke topik bantuan

17 Agustus – 13 September

  • Kenali dan bekerja sama dengan Estela dan komunitas WordPress
  • Berkolaborasi dengan Estela untuk menyempurnakan langkah-langkah proyek dan menyarankan {i>milestone<i} untuk penyelesaian
  • Buat jadwal untuk menyertakan {i>milestone<i} dan tugas mingguan
  • Atur ritme untuk pemeriksaan status dengan Estela (untuk mengatasi semua penghalang secara tepat waktu)

14 September – 30 November

  • Pekerjaan {i>kick-off<i} dan pengembangan proyek dengan Estela/mentor

2-5 Desember

  • Mengirimkan Laporan Produk Pekerjaan Akhir

3-10 Desember

  • Mengirimkan evaluasi dan evaluasi keberhasilan project terhadap pengalaman bekerja sama dengan mentor dan tim WordPress

Kesimpulan

WordPress adalah sistem pengelolaan konten (CMS) paling populer. Menurut W3techs, WordPress adalah CMS pilihan untuk 37,7% dari semua situs, memberi WordPress 63,6% dari pangsa pasar CMS.

Dengan tingkat popularitas ini, dokumentasi yang akurat dan mudah diikuti adalah suatu keharusan untuk merebut hati pengguna WordPress.

Dengan mempertimbangkan perjalanan pengguna dan pertanyaan yang menginformasikan kemungkinan jalur pengguna, WordPress dapat memodernisasi kategori bantuan dan pemberian tag untuk menjawab pertanyaan dan memecahkan masalah secara efektif. Dengan cara ini, WordPress akan terus menarik pelanggan yang puas selama bertahun-tahun ke depan.