Blizzard_APIDocumentation?

[zork]

I'm looking through the latest API changes and found that Blizzard added a new addon with 7.2 called: Blizzard_APIDocumentation

https://github.com/tomrus88/Blizzard...IDocumentation

What is this thing and how can be benefit from it?

*edit* Oh...
http://www.wowinterface.com/forums/s...ad.php?t=55257
https://www.townlong-yak.com/framexm...IDocumentation

WoW API changelog
https://wow.gamepedia.com/Patch_7.0.3/API_changes
https://wow.gamepedia.com/Patch_7.1.0/API_changes
https://wow.gamepedia.com/Patch_7.2.0/API_changes
https://wow.gamepedia.com/Patch_7.3.0/API_changes

[kurapica.igas]

Things like maybe, it's hard to keep those datas up-to-date in the old days.

[Tim]

From what I can remember is it will allow you to look up documentation via the client instead of 3rd party sites. Not sure if this will extend to events, etc. but, it's a good start.

[Fizzlemizz]

Just looking at the UnitDocumentation.lua from 7.3.5 to 8.0 they seem to be adding events and enum tables although it doesn't seem to list function returns to chat even though they are in the code.

[Resike]

This looks very weak, feels like even my documentation is more useful. (Currently working on Widget Reference):
https://github.com/Resike/BlizzardIn...ster/Resources

Also i'm not sure whats the point listing the type of arguments/return values and nilability, since it's Lua. It can be table, string or number (or nil) and 99,9% of the time you can tell what it is just by it's name.

Personally i would like to see something like this, and this is what i'm also aiming for:

GetPlayerMapPosition = { -- Returns the position of a unit on the current map
    args = {
        unit, -- The unitID for which the position is returned (string)
    }
    returns = {
        x, -- X value of the unit position (a proportion between 0 and 1, relative to WorldMapDetailFrame) (number)
        y, -- Y value of the unit position (a proportion between 0 and 1, relative to WorldMapDetailFrame) (number)
    }
}

And only add the arg/return types if done with everything.