Expand $args array parameters that are described in other functions

[tellyworth]

Quick WIP version. See #95.

Before, on the get_terms() function reference:

After, collapsed (detail/summary tag - note the teeny tiny triangle):

After, expanded:

Before, on get_posts(). Note that this one has a few arguments explicitly documented:

After, collapsed:

After, expanded (note that it still has the explicit docs first, I haven't hidden that):

There are definitely some improvements needed especially on the front-end. But this seems to work pretty well at recursing through and finding the correct array. For example it works with multiple levels of indirection, like wp_count_terms($args) -> get_terms($args) -> WP_Term_Query::__construct($query).

[ryelle]

I pushed up a commit to remove the summary wrapper from the description — that was stripping the semantics from everything inside it. It's best to just have the content in summary be a single text node (or heading).

I just changed it so it's "More Arguments". Feel free to change that to whatever works better :)

An example on get_posts:

And on wp_count_terms:

I'm also seeing <br> on all the params now, I think that's something new on this branch.

[tellyworth]

Thanks!

I'm not seeing the <br> thing at all. Not sure what's up with that. Some kind of nl2br formatting, maybe on import? I re-ran an import and it didn't reproduce.

I pushed a couple of commits riffing on this a bit. The summary now looks more obviously clickable, and explains where the extra info came from:

It's a bit better but still needs some work. Might be almost good enough to merge now for a designer to look at later - what do you think? Assuming I can fix the br thing.

[ryelle]

I'm not seeing the
thing at all. Not sure what's up with that. Some kind of nl2br formatting, maybe on import? I re-ran an import and it didn't reproduce.

🤷🏻 I'm not seeing them on trunk, just this branch. Ah okay — I just rebased and they're gone now. I'm not sure why you weren't seeing them but when this merges it should be fine, at least.

Might be almost good enough to merge now for a designer to look at later - what do you think?

That works for me. I don't think it should look like a link (since it's not taking you anywhere), but we can iterate on that later.