Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

API docs? #22

Open
shakiba opened this issue Feb 22, 2014 · 5 comments
Open

API docs? #22

shakiba opened this issue Feb 22, 2014 · 5 comments

Comments

@shakiba
Copy link

shakiba commented Feb 22, 2014

Is there any complete api doc available? I mean complete list of available classes/methods/properties?

@hunterloftis
Copy link
Owner

Afraid not, the originals grew out of sync with new development.

Any such docs would be greatly appreciated btw.

@shakiba
Copy link
Author

shakiba commented Feb 24, 2014

Would be great to be added, without them it's almost impossible to start using it.

I'm trying to create a Newton viewer for CutJS, p2.js viewer is already created.

@macu
Copy link

macu commented Feb 25, 2014

I'm wondering whether it might be better to document the Newton source files using /**-style comments and generate the documentation from that, e.g. using YUIDoc. This would at least help keep the documentation in sync with the code. We'd have to do some research to find the best tool for extracting/rendering the docs.

@hunterloftis
Copy link
Owner

@macu I dig that plan. Otherwise there's just no chance that the docs keep up.

I've used this tool for that in the past: https://github.com/cbou/markdox

@shakiba
Copy link
Author

shakiba commented Feb 25, 2014

You can also consider something like this, it is easy to keep updated manually and works as both manual and api-doc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants