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

Documentation Default Behavior and Suggestion for Improvement #116

Open
cfusterbarcelo opened this issue Nov 28, 2024 · 1 comment
Open
Assignees

Comments

@cfusterbarcelo
Copy link
Contributor

Issue:

As discussed in yesterday's meeting, the default documentation displayed on a model card currently seems to be the documentation from the specs repository. This behavior can be observed in models like chatty-frog:

image

The same behavior is also present in the placid-llama model.

Suggestion:

It would be helpful to include a message in such cases to clarify the absence of custom documentation. For example:

"There is no attached documentation provided by the authors/maintainers of this model. Please consult the source file and/or contact the author for more information. For general guidance on using models, refer to the BioImage.IO Documentation"

This message would provide better guidance to users when custom documentation is missing.

@FynnBe
Copy link
Member

FynnBe commented Nov 28, 2024

My hunch that there is a default at work was only partially correct; the documentation field is mandatory and has no default value, but as @mariana-gferreira pointed out to me the models in questions were created on the basis of the example notebook load_model_and_create_your_own.ipynb, which uses the spec README.md as a placeholder...
So there is no issue with the library, but the individual models need to be updated by their maintainers.

To avoid this from happening again I'll put a comment in the example notebook.

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