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 Documentation incomplete #9

Open
KonradHoeffner opened this issue Jan 30, 2023 · 4 comments
Open

API Documentation incomplete #9

KonradHoeffner opened this issue Jan 30, 2023 · 4 comments

Comments

@KonradHoeffner
Copy link

KonradHoeffner commented Jan 30, 2023

For example, there is no documentation on https://ayuei.github.io/DeBEIR/debeir/core/pipeline.html.
Please provide the missing documentation and add to the readme file, how it is generated.
This issue is part of the JOSS review at openjournals/joss-reviews#5017.

@Ayuei
Copy link
Owner

Ayuei commented Feb 2, 2023

Can you clarify what you mean by "how it is generated", does this mean the tool/library used to generate the documentation?

@KonradHoeffner
Copy link
Author

KonradHoeffner commented Feb 2, 2023

Yes, it would be nice to know after checking out the repository, how to generate the documentation.
But it doesn't need another full sentence, for example you could extend "Otherwise, html rendered documentation is available here" to something like "Otherwise, documentation generated by python insertdoctoolhere is available here."
HTML should be uppercase if you keep it.

Ayuei added a commit that referenced this issue Feb 8, 2023
@Ayuei
Copy link
Owner

Ayuei commented Feb 8, 2023

Hi, I added more documentation for all the components and added more examples for usage. I'll continually update this as there are still some spelling mistakes and missing documentation. But the core documentation should be there for users to get started.

I also included in the README.md how the documentation is generated and how to generate it yourself.

@KonradHoeffner
Copy link
Author

Thanks! I will check the appropriate box in the review, however I will leave this issue open as you said there is still missing documentation.

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

2 participants