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

Consider adding more documentation #14

Open
pdesaulniers opened this issue Dec 29, 2018 · 0 comments
Open

Consider adding more documentation #14

pdesaulniers opened this issue Dec 29, 2018 · 0 comments

Comments

@pdesaulniers
Copy link
Member

pdesaulniers commented Dec 29, 2018

Related: mruby-zest/mruby-zest-build#10

This is a pretty vague issue, but I think mruby-zest could do with more documentation overall. A lot of things can be inferred by looking at its code directly, but it's good to have some easily readable document too. I guess we should first determine the scope that the documentation should have.

Having something akin to an auto-generated doxygen site would be better than nothing. It would improve the discoverability of Zest's API.

I think pretty much anything there is to know about the QML files should be written. How they work, which callbacks are predefined (onSetup, onMouseMove), etc.

Code-wise, it would be nice to add summaries at the top of classes and functions in a few places.

Maybe the library is still too young for this. I think it's something to keep in mind, though.

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

No branches or pull requests

1 participant