-
Notifications
You must be signed in to change notification settings - Fork 53
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
DOC User guide for model cards #70
DOC User guide for model cards #70
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This needs some work to expand and explain things a bit better. Also needs to be added to index.rst
.
docs/model_card.rst
Outdated
leaderboard of the task and the dataset on `Papers with Code | ||
<paperswithcode.com>`__. | ||
|
||
Metadata part looks like below: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
what are the parts which are important for a scikit-learn model repo?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for writing this. Overall, it already reads quite well. I believe there are some possible improvements though. Apart from what Adrin wrote, I could see e.g. a bit more elaboration at the start about the intent of model cards, so that the reader knows what the goal is (perhaps a link to existing docs would be enough).
Co-authored-by: Benjamin Bossan <BenjaminBossan@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Content-wise, I'm fine with the addition. However, it doesn't render correctly. Please take a look.
Co-authored-by: Benjamin Bossan <BenjaminBossan@users.noreply.github.com>
Co-authored-by: Benjamin Bossan <BenjaminBossan@users.noreply.github.com>
Co-authored-by: Benjamin Bossan <BenjaminBossan@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks good to me. I also tried it locally and everything renders correctly.
I have made two suggestions but they're not important, up to you to decide if you want to add them.
Co-authored-by: Benjamin Bossan <BenjaminBossan@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM. I'll merge and then open a PR with a few suggestions.
Added user guide for model cards.