12 Comments

  1. Dovy

    Probably should have come about 6 months prior so adoption wouldn’t have been so sparse.

    At least they provided the information. +1 for that.

    Report

    • Paul

      Agreed. One of the problems with WordPress has always been the lack of documentation. New features are added regularly and developers are left to guess how to use them. One of such examples is the 3.5 media modal, which has no proper documentation yet, apart from some comments in the code itself.

      Report

      • Justin Tadlock

        That’s why WordPress.org could always use more volunteers, especially people who are willing to write documentation. Maybe we can get Jeff or Sarah to write an article about that.

        Report

        • Rick

          Ummmm….

          I hope the WP.Core realizes that one of the BIGGEST reasons that WordPress got a significant leg up on Jooml’r is documentation. I cannot BEGIN to tell you how many Jooml’r developers “jumped ship” because the people writing code were not documenting and I dont mean PHPDoc. In industry its pretty much mandatory.

          I’d got in a significant blowout with J!.Core abut this. I am a experienced programmer, 35+ years of it. Many (many) folks in their forums were asking about documentation months and months after J! MVC came to be. Mostly they heard silence back. We were doing some work, asked about some documentation. They then turned around and asked me if I wanted to document their code. I went, “Uhhh… Are you guys serious?” and they were.

          Imagine working at Microsoft and not documenting work. Visual studio function is METICULOUSLY documented. This is PART of writing software when other developers are to use it. Imagine if PHP were not documented or mySQL or Apache or Linux. This is simply not optional stuff. I dont like it any more than any other software engineer. I prefer to be writing code and not documenting my work. But, thats not optional.

          Standards. Hmmm…

          So, we want standardization of theme’s using Customizer but the folks that author it dont do their standard work in creating it? I would HIGHLY encourage WP.Core to let any developers know that are working on WP.Core function that they simply MUST document their work or they MUST have someone in place as they produce production code to do so or it wont become production code.

          I mean really… Adobe never documented Flash? Acrobat? Google never documented Android? Or Apples iOS? This is part of writing code. Its not just PHPDOC’n parameters in /output out and brief function. Its not fun but its the deal.

          Imagine people using DOVY’s framework and him saying, “Well… I wrote it but I expect all of you using it to document it”. I mean, what are we saying here, a guy that makes a theme framework is being more responsible than those making the application functions?

          While I appreciate the fact a new customizer documentation is now in place thats due to “chineese fire drill” apparently. “How can developers port themes into customizer if they have no good documentation, so we better make that happen”.

          Uhhh… maybe theme developers would not have had any of this happen at all or the TMT be deluged with themes not using customizer if proper documentation were in place from word go.

          If WP wants secure plugins, secure themes, best practices, all these things to be a reality then documentation is how that occurs and the responsibility to product it is the programmers. Thats basic college software engineering.

          Lets go to Microsoft or eBay or Adobe or Google and say, “I want a programmers job. I am a good programmer. But, I dont do documentation”.

          I could be the best programmer on the planet and I’d be shown the door.

          Report

          • Rick

            Not trying to be a weener here,

            I appreciate the hard work in getting the documentation you folks worked on in place.

            But, its also an opportunity for the TMT who authored these docs to send a message. That message being, “When WP coding is done, document it” and then developers can work with current information and make better software and wordpress becomes a better tool.

            Report

          • Justin Tadlock

            On the other hand, we can sit here, write essays about who should be writing documentation, and not get anything done at all. How about we take the route of getting more volunteers involved with core?

            Nevertheless, the Customizer API has been documented. It’s just now better documented, which is awesome! I still encourage more people to get involved with writing tutorials and documentation. Writing about a subject is actually a great way to learn more about it.

            Also, TRT (not TMT) didn’t author this documentation. Although, some people involved with the team have written tutorials on the subject in the past.

            Report

  2. Maria Antonietta

    It was about time to get a thorough tutorial out on the Customizer directly from WP.org. Thank you to the Theme Review Team members for the fantastic work on the Handbook, it’s invaluable!

    Report

  3. boldblocks

    Nicely written but they didn’t add a sample customizer code like in the old documentation which is going to give new adopters a hard time.

    Report

  4. Moonomo

    I’m a bit jealous for the developers who will get all about Customizer API in a single place (just kidding)- great work done with the docs.

    I had to learn all of it by looking at code (actually that’s the best way)- I wish to join the team to give my hands on things, hopefully soon.

    Report

  5. David McCan

    Thank you to Otto and Nick for adding documentation and posts about using the customizer.

    Report

  6. Rick

    Thank you Nick & Otto

    Report

Comments are closed.

%d bloggers like this: