Cuberite Forum
Documentation drive - Printable Version

+- Cuberite Forum (https://forum.cuberite.org)
+-- Forum: Plugins (https://forum.cuberite.org/forum-1.html)
+--- Forum: Plugin Discussion (https://forum.cuberite.org/forum-8.html)
+--- Thread: Documentation drive (/thread-1214.html)

Pages: 1 2 3 4 5 6 7


RE: Documentation drive - xoft - 12-02-2013

Great, assign the issue to yourself, then, and maybe even drop a line there, so that noone else starts it.
https://github.com/mc-server/MCServer/issues/382


RE: Documentation drive - xoft - 02-20-2014

I'm bringing this up again, the documentation has somewhat stalled. There are quite a few new functions that need documenting and several functions that have been removed.

When you commit new Lua-enabled code, please take the time and add documentation, too. I'm asking nicely now, but I'm seriously considering rejecting any PR that doesn't do this in the future.


RE: Documentation drive - tigerw - 02-20-2014

I did itBig Grin


RE: Documentation drive - xoft - 03-01-2014

Is there anyone brave enough to dive deep into APIDump's code and make it export not only the HTML dump, but also the dump in a format readable by ZeroBrane Studio?

Ref.:
ZeroBrane Studio: http://studio.zerobrane.com/
ZBS API format: http://studio.zerobrane.com/doc-api-auto-complete.html
ZBS forum thread: https://forum.cuberite.org/showthread.php?tid=1392

EDIT: This has been implemented, see the article on Setting up ZBS for details on how to make it work.


RE: Documentation drive - worktycho - 03-01-2014

It would probably be useful to add the capability to InfoDump as well, particularly for large projects like worldedit.


RE: Documentation drive - xoft - 03-01-2014

I'm not following you here. What has InfoDump in common with this? We need the MCServer's API, and that means APIDump. InfoDump does plugin descriptions, there's nothing in the ZBS to consume such data.


RE: Documentation drive - worktycho - 03-01-2014

Interplugin calls. e.g. handy. Might be useful to see if Zerobane studio can recognise them. if not theres no point.


RE: Documentation drive - xoft - 03-01-2014

Interplugin calls are handled using strings, I don't think there's any way for ZBS to recognise those:
local Result1, Result2 = cPluginManager:CallPlugin("Handy", "FunctionName", arg1, arg2)



RE: Documentation drive - worktycho - 03-02-2014

Ok, don't know that much about how ZBS works so I had no idea whether it could recognise them.


RE: Documentation drive - xoft - 10-22-2014

I'm resurrecting this thread from the dead. The documentation has become lacking again. There are many new classes that have none of their functions documented (projectiles, entities). I therefore urge everyone to write documentation together with writing code. And to practice, we should all try to complete the documentation. After all, it is even used while developing plugins - ZeroBrane Studio reads it and provides code completion and infotips based on it.