On 06.05.2020 at 08:25, Maciej Sobaczewski wrote: > I'm on the fence when it comes to the feature itself so I will skip that > part entirerly but I'd like to draw attention to one more problem. Many > PHP Manual translations translate the parameter names, too - both in > text, as well as in the function/method signatures themselves. > > We would need to fix every such occurence for every language (at least > active ones but there are still couple of them). Otherwise documentation > will become highly misleading. > > Most people probably use IDEs of course but it still doesn't change the > fact that the manual cannot be totally out of sync with what could > become the language syntax.
I hope that we will be able to generate the <methodsynopsis> elements automatically from the stubs (which would likely require some more meta-information in the doc blocks). These could then automatically be injected into the docs. Of course, someone would have to contribute the required scripts. :) -- Christoph M. Becker -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
