codex นั้นไม่มีการบำรุงรักษาอย่างแข็งขันอีกต่อไปหรือไม่?

ฉันโดยทั่วไป Google เมื่อฉันต้องการการอ้างอิงอย่างรวดเร็วสำหรับฟังก์ชั่น Wordpress และโดยทั่วไปเป็นโพสต์ Codex ที่เกิดขึ้นก่อน (เช่นhttps://codex.wordpress.org/Function_Reference/get_termเมื่อ Googling 'get-term')

ฉันได้รับการอาศัย Codex สำหรับปีและเป็นรางทราบว่ามีการอ้างอิงรหัสแยกต่างหาก (เช่น. https://developer.wordpress.org/reference/functions/get_term/ ) ที่ไม่ให้รายละเอียดมากขึ้นกว่า Codex ... แต่ส่วนใหญ่ดูเหมือนจะเป็นรายชื่อที่ซ้ำกัน บางครั้งสิ่งนี้จะกลับมาเป็นอันดับแรกในการค้นหาของ Google แทน

แต่เมื่อเร็ว ๆ นี้ฉันได้พบความแตกต่างระหว่างสอง ... และดูเหมือนว่า Codex อาจล้าสมัยในบางสิ่ง ตัวอย่างเช่น สองการเชื่อมโยงดังกล่าวข้างต้น - ผมใช้เวลาสักหน่อยเวลาอ่านตั๋ว Trac ก่อนที่ผมจะตระหนักว่าเป็นจริงไม่ได้เป็นพารามิเตอร์ที่จำเป็นบน$taxonomy get_term()ผมกำลังอยู่บนเส้นทางที่สวนเพราะ Codex ยังรายการที่มันถูกต้อง

ฉันไม่เห็นที่ใดก็ได้ใน Codex ที่กล่าวถึงว่าเลิกใช้แล้วถึงแม้ว่าจะมีลิงก์ไปยังการอ้างอิงโค้ดที่ด้านบนของแต่ละหน้า

ไม่มีใครรู้ว่าถ้า Codex จะเลิก? มันยังคงให้บริการวัตถุประสงค์หรือไม่? หรือฉันควรจะสวยมากไม่สนใจมันและเพียงแค่ใช้developer.wordpress.org ?

(อืมนี่ค่อนข้างนอกหัวข้อ แต่จะให้ผู้อื่นตัดสินใจได้)

คำตอบที่ดีกว่า

แม้ว่าจะเป็นการยากที่จะติดตามการประกาศอย่างเป็นทางการเนื่องจาก @darmb ชี้ให้เห็นในความคิดเห็นที่มีข้อบ่งชี้ว่าความพยายามในการจัดทำเอกสารอย่างเป็นทางการกำลังลอยห่างจาก codex เพื่อสนับสนุนเว็บไซต์นักพัฒนาและบล็อก / ไซต์ที่ "สร้าง" ดังนั้นในขณะที่ไม่ได้ประกาศอย่างเป็นทางการ (เท่าที่เป็นไปได้ที่จะเห็น) codex ควรได้รับการปฏิบัติราวกับว่ามันเลิกใช้แล้ว

อ้างอิง:

• "... โดยมีเป้าหมายสูงสุดคือการปิด Codex ในที่สุด" ( ลิงก์ )
• "The Codex เลิกใช้แล้วและมีกำหนดจะหายไปในบางจุดดังนั้นหน้า Review Theme บน Codex จะไม่เป็นทางการอีกต่อไปหรือได้รับการบำรุงรักษา" ( ลิงก์ )

คำตอบเดิม

Codex เป็นเว็บไซต์สไตล์วิกิ การอัพเดทนี้ต้องการอาสาสมัครบางคนที่จะไปแก้ไขจริง โดยทั่วไปแล้วด้วยรหัสใหม่คุณจะได้รับสิ่งนั้นถึงแม้ว่าคุณภาพอาจจะไม่ใช่สิ่งที่ยอดเยี่ยมที่สุด แต่ก็อาจได้รับ "bitrot" ในหัวข้อเก่าที่มีการเปลี่ยนแปลงเล็กน้อย

เว็บไซต์สำหรับนักพัฒนาเป็น phpdoc สไตล์ไซต์อัตโนมัติที่สร้างขึ้นจากความคิดเห็นสไตล์ phpdoc ที่มาพร้อมกับการประกาศฟังก์ชั่นและการใช้เบ็ดดังนั้นมันจะซิงค์กับรหัสจริง (และคุณสามารถเห็นรหัสที่นั่น)

จุดปวดของ Codex - มันอาจแตกต่างจากคำอธิบายที่แท้จริงถ้าไม่มีใครใส่ใจเกี่ยวกับ API บางอย่าง จุดแข็งมันเป็นมนุษย์สร้างขึ้นสำหรับมนุษย์และในทางทฤษฎีง่ายต่อการแก้ไข

จุดปวดของเว็บไซต์นักพัฒนา - สำหรับรุ่นล่าสุดเท่านั้นและขึ้นอยู่กับคุณภาพของความคิดเห็นในรหัสสิ่งที่เปลี่ยนแปลงอาจเปลี่ยนแปลงเพียงทุก 4 เดือน จุดแข็ง - มันแสดงให้คุณเห็นรหัสมันเป็นตัวแทนการใช้ตัวแก้ไขข้อความเพื่อค้นหาในรหัส

ฉันคิดว่าข้อมูลที่ทำให้เข้าใจผิดนั้นแย่กว่านั้นไม่มีข้อมูลดังนั้นฉันจึงพยายามหลีกเลี่ยง codex แต่ไม่ใช่มันไม่ได้คัดค้านและถ้าคุณพบช่องว่างที่นั่นคุณยินดีเติม :)