Re: Documenting APIs and bug #15

Hi Dominique,

Indeed, its a big issue and I forgot about that one.

Can you tell me if it gets improved when you try on the /upgrade/ namespace?

I'm not working on templating issues these days, but maybe somebody else
(Eliezer?) would find something to do?

  [0]: http://docs.webplatform.org/upgrade/dom/Navigator/getUserMedia

Renoir
~


On 2014-05-07, 6:51 AM, Dominique Hazael-Massieux wrote:
> Hi,
>
> Bug #15 [1] highlights a killer bug for documenting APIs: it means that
> when you document the parameters of a given method, the parameters are
> not displayed in the correct order, making the documentation basically
> misleading.
>
> While the bug is reported on the canvas API, it applies really to any
> method documentation, making WPD pretty much unusable for documenting
> APIs.
>
> I've suggested a couple of possible approaches to fix this in [1] (none
> great unfortunately); but since I haven't seen much activity on this,
> and given how critical the bug seems to me, I thought I would raise
> attention to it on the list as well.
>
> Dom
>
> 1. http://project.webplatform.org/tmpl/issues/15