Kodeks artık aktif olarak tutulmuyor mu?

Bir Wordpress işlevi için hızlı bir referansa ihtiyaç duyduğumda genellikle Google'ım ve genellikle ilk olarak gelen bir Codex yayınıdır (ör. Https://codex.wordpress.org/Function_Reference/get_term , Google 'get-term' Googling yaparken).

Yıllardır kodeksine güvenerek ve ayrı Kod Referans olduğunu belli belirsiz farkındaydı oldum (örn. Https://developer.wordpress.org/reference/functions/get_term/ ) o did Kodeksi daha ayrıntı vermek ... ancak çoğunlukla yinelenen bir liste gibi görünüyordu. Bazen bu, Google aramalarında önce gelir.

Ama son zamanlarda ikisi arasında tutarsızlıklarla karşılaştım ... ve sanki Kodeks bazı şeylerde güncel olmayabilir. Örneğin, yeniden. Yukarıdaki iki bağlantı - Ben $taxonomygerçekten gerekli bir parametre artık fark önce biraz trac bilet okumak için geçirdim get_term(). O Codex hala listeleri çünkü bahçe yolunda idi edilir gerektiriyordu.

Her sayfanın en üstündeki Kod Referansına bağlantılar olmasına rağmen, Kodeks'te kullanımdan kaldırıldığını belirten hiçbir yerde göremiyorum.

Kodeks'in kullanımdan kaldırılıp bırakılmadığını bilen var mı ? Hala bir amaca hizmet ediyor mu? Yoksa hemen hemen görmezden gelmeli miyim ve developer.wordpress.org'u mı kullanmalıyım ?

(hmm bu biraz konu dışı, ancak başkalarının karar vermesine izin verecek)

Daha iyi cevap

Resmi duyuruyu izlemek zor olsa da, @darmb yorumlarda belirtildiği gibi, resmi dokümantasyon çabasının geliştirici sitesi ve "marka" blogları / siteleri lehine kodeksinden uzaklaştığına dair göstergeler var. Dolayısıyla, bir şekilde, resmi olarak açıklanmasa da (görebildiği kadarıyla), kodeks onaylanmamış gibi ele alınmalıdır.

Referanslar:

• “... nihai amaç sonunda Kodeks'i kapatmak.” ( bağlantı )
• "Kodeks kullanımdan kaldırıldı ve bir noktada ortadan kaybolacak. Bu nedenle, Kodeks'deki Tema İnceleme sayfası artık resmi değil veya korunuyor." ( bağlantı )

Orijinal cevap

Kodeks wiki tarzı bir sitedir. Güncel olması bazı gönüllülerin gerçekten gitmesini ve düzenlemesini gerektirir. Genellikle yeni kodla, orada bir şey elde edersiniz, ancak kalite en büyük olmayabilir, ancak küçük değişikliklerle eski konularda "bitrot" muzdarip olabilir.

Geliştirici sitesi, işlev bildirimlerine ve kanca kullanımına eşlik eden phpdoc stil yorumlarından otomatik olarak oluşturulan bir phpdoc stil sitesidir, bunun için gerçek kodla senkronize edilir (ve aslında kodu orada görebilirsiniz).

Kodeksin acı noktası - hiç kimse API'yi umursamıyorsa gerçek açıklamadan farklı olabilir. İnsan için üretilen güçlü bir nokta ve teorik olarak düzenlemek daha kolay.

Geliştirici sitesinin acı noktası -it sadece son sürüm içindir ve koddaki yorumların kalitesine bağlıdır, ortalama bir şey sadece 4 ayda bir değişebilir. Güçlü nokta - kodda arama yapmak için metin düzenleyicisini kullanmak yerine kendi kendine kodu gösterir.

Ben yanıltıcı bilgi daha sonra hiçbir bilgi daha kötü olduğunu düşünüyorum ve bu nedenle kodeksi önlemek için çalışıyorum, ama hayır, itiraz değil ve orada bir boşluk bulursanız doldurmak için bekliyoruz :)