Là codex không còn được duy trì tích cực?

Tôi nói chung là Google khi tôi cần một tài liệu tham khảo nhanh cho chức năng Wordpress và nói chung đó là bài đăng Codex xuất hiện đầu tiên (ví dụ: https://codex.wordpress.org/Function_Reference/get_term khi Google 'nhận thuật ngữ').

Tôi đã dựa vào codex trong nhiều năm và nhận thức mơ hồ rằng có một Tài liệu tham khảo mã riêng biệt (ví dụ: https://developer.wordpress.org/reference/fifts/get_term/ ) đã cung cấp nhiều chi tiết hơn Codex ... nhưng chủ yếu là một danh sách trùng lặp. Đôi khi điều này trả về đầu tiên trong các tìm kiếm Google thay thế.

Nhưng gần đây tôi đã gặp phải sự khác biệt giữa hai ... và có vẻ như Codex có thể đã lỗi thời về một số thứ. Ví dụ, tái. hai liên kết ở trên - Tôi đã dành một chút thời gian để đọc vé trac trước khi tôi nhận ra rằng đó $taxonomythực sự không còn là một tham số bắt buộc get_term(). Tôi đã đi trên con đường vườn vì Codex vẫn liệt kê rằng nó là bắt buộc.

Tôi không thể thấy bất cứ nơi nào trên Codex đề cập đến việc nó không được chấp nhận, mặc dù có các liên kết đến Tham chiếu mã ở đầu mỗi trang.

Có ai biết Codex có bị phản đối không? Nó vẫn phục vụ một mục đích? Hay tôi nên bỏ qua nó và chỉ sử dụng developer.wordpress.org ?

(hmm, điều này hơi lạc đề, nhưng sẽ để người khác quyết định về nó)

Câu trả lời tốt hơn

Mặc dù rất khó để theo dõi thông báo chính thức, như @darmb đã chỉ ra trong các bình luận, có dấu hiệu cho thấy nỗ lực tài liệu chính thức đang trôi tuột khỏi codex có lợi cho trang web của nhà phát triển và blog / trang web "tạo ra". Vì vậy, theo một cách nào đó, trong khi không được công bố chính thức (theo như có thể thấy), codex nên được xử lý như thể nó không được dùng nữa.

Người giới thiệu:

• "... với mục tiêu cuối cùng là cuối cùng sẽ đóng cửa Codex." ( liên kết )
• "Codex không được chấp nhận và dự kiến ​​sẽ biến mất vào một lúc nào đó. Do đó, trang Đánh giá chủ đề trên Codex không còn chính thức hoặc được duy trì." ( liên kết )

Câu trả lời gốc

Codex là một trang web theo phong cách wiki. Nó được cập nhật đòi hỏi một số tình nguyện viên thực sự đi và chỉnh sửa nó. Thông thường với mã mới, bạn sẽ nhận được một cái gì đó ở đó, mặc dù chất lượng có thể không phải là tốt nhất, nhưng nó có thể bị "bitrot" trong các chủ đề cũ hơn với những thay đổi nhỏ.

Trang web dành cho nhà phát triển là trang tự động kiểu phpdoc được tạo từ các nhận xét kiểu phpdoc kèm theo khai báo hàm và sử dụng hook, do đó nó đồng bộ với mã thực tế (và bạn thực sự có thể thấy mã ở đó).

Điểm đau của codex - nó có thể tách khỏi mô tả thực tế nếu không ai quan tâm đến một số API. Điểm mạnh đó là do con người tạo ra cho con người và trên lý thuyết dễ chỉnh sửa hơn.

Điểm đau đớn của trang web dành cho nhà phát triển - nó chỉ dành cho phiên bản mới nhất và phụ thuộc vào chất lượng của các bình luận trong mã, một cái gì đó mà trên avarage có thể chỉ thay đổi sau mỗi 4 tháng. Điểm mạnh - nó hiển thị cho bạn mã tự nó, là một thay thế cho việc sử dụng trình soạn thảo văn bản để tìm kiếm trong mã.

Tôi nghĩ rằng thông tin sai lệch là tồi tệ hơn thì không có thông tin và do đó tôi cố gắng tránh codex, nhưng không, nó không bị phản đối, và nếu bạn tìm thấy một khoảng trống ở đó, bạn có thể lấp đầy nó :)