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

No API documentation #660

Open
steve-biggs-fox opened this issue Mar 25, 2024 · 1 comment
Open

No API documentation #660

steve-biggs-fox opened this issue Mar 25, 2024 · 1 comment

Comments

@steve-biggs-fox
Copy link

There is no API documentation. There is a basic tutorial that shows how to print FMU info, run it and plot the results, but that is all. For anything else, it just says to see the examples. Really, this needs API documentation to say what functions are available, how to call them, what is returned, etc. For example, how do I run an FMU with non-default parameters? What is this SimulationResult object that is returned? How do I access specific output variables? etc. Sure, I might be able to work it out from the examples, but that is long and annoying. API documentation would get straight to the point. And sure, I can type help(function_name), but then I have to use auto-complete to see what's available, remember where all the different functions are, etc. which is difficult when you're new to a package. API documentation would provide an overview of everything for reference while learning. Plus, I think it would be easy to create since you already have the docstrings - you just need a package to parse that and auto-generate the docs (many such packages exist). Please consider creating API documentation. Thank you

Other than that, from what I've seen so far, this seems like a great package, so thanks for creating it :)

@moonglaivecn
Copy link

As a beginner, I also really need the API documentation. Reading the source code to understand how each method is used is indeed quite inefficient.

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

3 participants