[00:17:41] TimStarling: aye yeah I figured out the docgen boilerplate, but the default leaves a lot to desire. e.g. return types are all mixed for excimer methods it seems, so I'm guessing there's at least some potential to improve that "upstream" (i.e. excimer.git), but I have no sense of where to start that. The default boileerplate is actually rejected by the docgen validator due to missing an "examples" chapter, but I figured out from copying [00:17:41] other examples how to work that in. [00:18:30] oh, I see. I think I misunderstood the relation between what you committed in doc-en vs what's in the luasandbox repo. So one doesn't feed into the other, but they're copies really. [00:19:29] https://usercontent.irccloud-cdn.com/file/ChyEfPwJ/Screenshot%20docbook.png [00:19:51] it seems to only pick up the global function, not the classes. [00:20:03] not very helpful [00:20:28] the manual copy in the luasandbox repo can be deleted now, I think [00:22:03] docgen.php does have code for generating classes [00:23:19] try docgen.php --class=ExcimerTimer [00:24:50] gen_extension_markup() does try to get the class list from ReflectionExtension::getClasses() [00:27:37] hm.. ok, so I think it did generate something but it's probably just missing something to include it in the index [00:28:15] I have entities.excimertimer.xml entities.excimerlogentry.xml etc now, but I guess it's ignoring them, the boilerplate didn't include them in the book [00:36:18] warnings: https://phabricator.wikimedia.org/P49402