Apakah kodeks tidak lagi dipelihara secara aktif?

9

Saya biasanya Google ketika saya membutuhkan referensi cepat untuk fungsi Wordpress, dan umumnya itu adalah posting Codex yang muncul lebih dulu (mis. Https://codex.wordpress.org/Function_Reference/get_term ketika Googling 'mendapatkan istilah').

Saya telah mengandalkan codex selama bertahun-tahun, dan samar-samar menyadari bahwa ada Referensi Kode yang terpisah (mis. Https://developer.wordpress.org/reference/functions/get_term/ ) yang memang memberikan lebih detail daripada Codex ... tetapi sebagian besar tampaknya merupakan daftar duplikat. Terkadang ini kembali lebih dulu dalam pencarian Google.

Tapi baru-baru ini saya menemukan perbedaan antara keduanya ... dan sepertinya Codex mungkin ketinggalan zaman pada beberapa hal. Misalnya, ulang. dua tautan di atas - saya menghabiskan sedikit waktu membaca tiket trac sebelum saya menyadari bahwa $taxonomymemang tidak ada lagi parameter yang diperlukan get_term(). Aku berada di jalan kebun karena Codex masih daftar itu adalah diperlukan.

Saya tidak bisa melihat di mana pun di Codex yang menyebutkan itu sudah usang, meskipun ada tautan ke Referensi Kode di bagian atas setiap halaman.

Adakah yang tahu kalau Codex sudah usang? Apakah masih melayani tujuan? Atau haruskah saya mengabaikannya dan hanya menggunakan developer.wordpress.org ?

Tim Malone
sumber

Jawaban:

8

(hmm ini agak di luar topik, tetapi akan membiarkan orang lain memutuskannya)

Jawaban yang lebih baik

Walaupun sulit untuk melacak pengumuman resmi, seperti yang ditunjukkan oleh @armb dalam komentar, ada indikasi bahwa upaya dokumentasi resmi menjauh dari kodeks demi situs pengembang, dan "membuat" blog / situs. Jadi, meski tidak diumumkan secara resmi (sejauh mungkin untuk dilihat), kodeks tersebut harus diperlakukan seolah-olah sudah ditinggalkan.

Referensi:

  • "... dengan tujuan akhir adalah untuk akhirnya mematikan Codex." ( tautan )
  • "Codex sudah usang, dan dijadwalkan untuk pergi pada beberapa titik. Dengan demikian, halaman Theme Theme pada Codex tidak lagi resmi, atau dipelihara." ( tautan )

Jawaban asli

Kodeks adalah situs gaya wiki. Menjadi terbaru membutuhkan beberapa sukarelawan untuk benar-benar pergi dan mengeditnya. Biasanya dengan kode baru Anda akan mendapatkan sesuatu di sana, meskipun kualitas mungkin bukan yang terbesar, tetapi mungkin menderita "bitrot" pada topik lama dengan perubahan kecil.

Situs pengembang adalah situs gaya phpdoc otomatis dihasilkan dari komentar gaya phpdoc yang menyertai deklarasi fungsi dan penggunaan hook, karenanya disinkronkan dengan kode aktual (dan Anda benar-benar dapat melihat kode di sana).

Pain point of codex - mungkin menyimpang dari deskripsi aktual jika tidak ada yang peduli tentang beberapa API. Poin kuatnya adalah yang dihasilkan manusia untuk manusia dan secara teori lebih mudah diedit.

Titik sakit dari situs pengembang -itu hanya untuk versi terbaru dan tergantung pada kualitas komentar dalam kode, sesuatu yang pada rata-rata dapat berubah hanya setiap 4 bulan. Poin kuat - ini menunjukkan kepada Anda kode itu sendiri, sebagai pengganti untuk menggunakan editor teks untuk mencari dalam kode.

Saya pikir informasi yang menyesatkan lebih buruk daripada tidak ada informasi dan oleh karena itu saya mencoba menghindari kodeks, tetapi tidak, itu tidak ditinggalkan, dan jika Anda menemukan celah di sana Anda dapat mengisinya :)

Mark Kaplun
sumber
Sempurna, terima kasih banyak untuk penjelasan Mark ini. Saya tidak menyadari situs pengembang didokumentasikan secara otomatis, itu masuk akal. Sehubungan dengan pertanyaan di luar topik, saya mempertanyakan itu sendiri sebelum mempostingnya, tetapi saya telah mencari di Google dan tidak dapat menemukan jawaban .. dan itu berhubungan langsung dengan Wordpress .. Saya pikir jika saya melihatnya di sini saya akan berpikir itu pertanyaan yang bagus, jadi saya memutuskan untuk tetap mempostingnya. Senang diberi tahu sebaliknya!
Tim Malone
2
Sebenarnya membaca ulang wordpress.stackexchange.com/help/on-topic , saya tidak mengerti bagaimana ini di luar topik ...
Tim Malone
@TimMalone, pertanyaan wordpress.org harus diarahkan ke hal-hal wordpress.org. Otto terlihat di sini dari waktu ke waktu tetapi jika tidak ada orang yang berwenang untuk menjawab pertanyaan seperti ini yang ada di sekitar sini. Anda pada dasarnya bertanya tentang rekomendasi untuk "buku";)
Mark Kaplun
1
Sebenarnya Codex sedang dalam proses menjadi usang karena dokumen pengembang baru dibuat. Banyak halaman Codex sekarang secara otomatis dialihkan ke dokumen pengembang baru.
darrinb
1
Ada referensi untuk Codex yang tidak digunakan lagi di sini: make.wordpress.org/themes/2015/05/05/27/…
darrinb