Specifically regarding the iframe discrepancy – Jacob Peattie was right in the comments. This was caused by jetpack’s builtin blocks not being registered with version 3. Once I disabled them via Jetpack -> Settings -> Writing -> Composing and unchecking “Jetpack blocks give you the power…”, the iframe appeared as expected. Here’s the link explaining … Read more
They’re all in the codex page for WP_Query.
I would say the section Constants in the WordPress: PHP Documentation Standards is pretty clear. It should look like this: /** * Summary. * * @since x.x.x (if available) * @var type $var Description. */ define( ‘MY_CONST’, ‘Hello’ );
I believe the practice of including additional data within PHP code comments is typically called annotations. WordPress core makes no use of annotations technique for any code runtime tasks and doesn’t have an API for such purpose. In number of context it will read file headers to extract meta data, such as main plugin files … Read more
PHPStorm and CodeSniffer do not recognize WPCS [closed]
“@see” tag is used somehow randomly No wonder as any documentation in the end depends on the programmer’s decision of what is worthy of being documented and how. Documentation in general should not be a verbal description of the code unless the code is extremely non trivial, but add a human friendly summery of what … Read more
Interconnect/Spectacula folks manage free WordPress User Guide for training users.
VTC and Lynda have very good training videos on this.
You don’t document function calls, but function definitions. Because the function could be called unlimited times, right? So it makes no sense to document functions when they are called. If you document the call, then probably because you do some things you want to remember later – or let other following developers know. But normally, … Read more
I’m not aware of any besides michel fortin’s WP text flow diagram from a few years ago: http://michelf.com/weblog/2005/wordpress-text-flow-vs-markdown/ That said, there were recent talks about writing some kind of plugin dev’s companion reference with the full flowchart of the WP hooks and API.