Clarify safety and ease of use

Open Beginner friendly
#67 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
python
Domain
documentation

Research direction

Read the cited passages in README and docs/index.md, then review the concern in PR #66. Clarify the wording in both locations so ease of use is not confused with needing no understanding of the model’s limitations and biases. Done means both statements communicate that distinction consistently.

Written by the indexing model from the issue text.

Description

documentation

In PR #66 a concern was raised about content saying pybioclip doesn't require ML knowledge to run. The concern is users might take this to mean they do not need to understand the limitations and biases present in the underlying model.
See https://github.com/Imageomics/pybioclip/pull/66#discussion_r1859335707 for more.

Two places may need adjustment:

  • README

    ... No particular understanding of ML or computer vision is required to use it. ...

  • docs/index.md

    No particular coding knowledge of ML or computer vision is required to use pybioclip.

Dominant language
Python
Stars
67
Forks
14
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Imageomics/pybioclip

All issues in Imageomics/pybioclip

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.