WordPress.org

Ready to get started?Download WordPress

Forums

Feedback on Custom Post Types Documentation (7 posts)

  1. stvcg1
    Member
    Posted 3 years ago #

    HI,
    Some constructive criticism on the documentation for "Custom Post Types"...
    http://codex.wordpress.org/Custom_Post_Types

    Under the paragraph...

    "Adding a custom type to WordPress is done via the register_post_type function. This function allows you to define the post type and how it operates within WordPress."

    I wish you would be more specific when stating

    "Adding a custom type to WordPress"...

    Where in word press? Under the theme code? plug in code? config code?

    Right now the language seems to speaking to user that have been using the product. I feel like if you speak to both new developers and experienced developers it would benefit your adoption rate.

    I hope this helps! =D

  2. sdodev
    Member
    Posted 3 years ago #

    stvg1, I understand what your saying. Generally you will find that problem with any coding documentation. The problem is stuff like that is covered pretty thoroughly in other areas, so rewriting that content into other places in the codex just for the sake of re-explaining leads to a lot of redundancy. It would kind of be like explaining how if/then logic works every time you use the statements.

    That page is more for explaining the actual function than a specific case example on how to use it.

    In response to your question though, the register_post_type function would be used either in your functions.php file or in a secondary plugin traditionally :)

  3. stvcg1
    Member
    Posted 3 years ago #

    Hi sdodev
    Thank you for the reply... I appreciate your help...

    I agree redundancy is fine balance and the best way to find that balance is usability testing with your target audiences, and you guys are the cms experts and offering a high quality open source solution =O)

    As a newbie perspective I would like to suggest you and the team consider rephrasing the sentence as so... It is a small change but I feel like it will help many newbie PHP developers that trying get to speed fast on the system...

    "Adding a custom type to functions.php in your theme..."

    I hope this helps... From my perspective "newbie wordpress developer" there are roughly 50 CMS systems on market today... and many of them are different... So when I am trying to learn fast the more specific with the sample code the better this helps use so I can cut copy and paste the example code and dissect it to learn... =D

    I really like the product and I hope this feedback helps the team... =D

    Sincerely
    Steve

  4. The Codex is contributed to by volunteers and can be edited by anyone with a support forum login. Please feel free to contribute anything that you feel would improve the documentation there.

  5. stvcg1
    Member
    Posted 3 years ago #

    Hi James
    Thank you for your reply...
    How do you recommend I suggest edits?

    Sincerely
    Steve

  6. Just login to the Codex with your support forum login, find the page you wish to edit, and click the "Edit" link.

    http://codex.wordpress.org/Contributing_to_WordPress

  7. mrmist
    Forum Janitor
    Posted 3 years ago #

    You can also use the "discussion" page which is linked off of every page in order to discuss potential changes before altering the page itself.

Topic Closed

This topic has been closed to new replies.

About this Topic