WordPress.org

Ready to get started?Download WordPress

Forums

Codex needs some love (4 posts)

  1. nilsjeppe
    Member
    Posted 6 years ago #

    Hello people,

    I am just trying to update to 2.3, and at the same time I am updating some plugins (that notification functionality is neat!). So one of them needed to be patched to work in the slightly non-standard setup I have. To do this smartly, I needed to find out how I can get the plugin path.

    After about half an hour trying to find what I need in the Codex, I gave up and just hardcoded it in an extremely ugly way.

    Let me be frank: The wordpress documentation is a complete mess. It's outdated, it's badly organized, it seems incomplete, and above all, the search engine sucks.

    Please clean up that mess, so that people who are not hardcore wordpress developers stand a chance to figure out how to do anything. Your benefit: You'll have a much greater chance for someone like me to actually contribute something worth-while back. Had I been able to patch the plugin in a good, universal way, I'd be able to submit it back to the maintainer, and other might benefit.

  2. whooami
    Member
    Posted 6 years ago #

    how bout you clean up that "mess"? the codex is USER generated content; you are a user.

  3. Ivovic
    Member
    Posted 6 years ago #

    I feel your frustration.

    WordPress is just another in a long line of developments which suffers from issues with documentation.

    It's the nature of the beast... documentation is the least fun, and the least relevant to those with the knowledge to document it.

    It does need to be done, I agree completely, but it's hard enough to get it done properly when you're paying people to do it... let alone when time-poor developers have to drop bug fixes or new features and put their technical writing hats on.

    It sucks, but it's certainly understandable.

    Having said all that, wordpress is one of the better examples out there, of volunteer-based support and documentation. Far from perfect, I agree, but nowhere near 'bad'.

  4. MichaelH
    Member
    Posted 6 years ago #

Topic Closed

This topic has been closed to new replies.

About this Topic