Skip to content

📝 Docs: README lacks installation and usage guidance#34936

Open
letho1608 wants to merge 1 commit intoopenvinotoolkit:masterfrom
letho1608:contribai/docs/readme-lacks-installation-and-usage-guid
Open

📝 Docs: README lacks installation and usage guidance#34936
letho1608 wants to merge 1 commit intoopenvinotoolkit:masterfrom
letho1608:contribai/docs/readme-lacks-installation-and-usage-guid

Conversation

@letho1608
Copy link

📝 Documentation

Problem

The top‑level README provides only a logo, key‑feature links, and badges. It does not contain
any instructions on how to install the OpenVINO Toolkit (pip, conda, Docker, source build),
nor does it give a quick‑start example or a link to the API reference. New contributors
and users will be unable to get the library up and running from the README alone.

Severity: high
File: README

Solution

Add a dedicated “Installation” section that lists the supported installation methods
(pip, conda, Docker, source) with example commands. Follow it with a “Quick Start”
section that shows a minimal inference script and a “API Reference” link to the
autogenerated docs. Example snippet:

Changes

  • README.md (modified)

Details:

  • item1
  • ...

Tickets:

  • ticket-id

AI Assistance:

  • AI assistance used: no / yes
  • If yes, summarize how AI was used and what human validation was performed (build/tests/manual checks).

🤖 About this PR

This pull request was generated by ContribAI, an AI agent
that helps improve open source projects. The change was:

  1. Discovered by automated code analysis
  2. Generated by AI with context-aware code generation
  3. Self-reviewed by AI quality checks

If you have questions or feedback about this PR, please comment below.
We appreciate your time reviewing this contribution!

Closes #34935

The top‑level README provides only a logo, key‑feature links, and badges.  It does not contain
any instructions on how to install the OpenVINO Toolkit (pip, conda, Docker, source build),
nor does it give a quick‑start example or a link to the API reference.  New contributors
and users will be unable to get the library up and running from the README alone.


Affected files: README.md

Signed-off-by: Le Quang Tho <92069270+letho1608@users.noreply.github.com>
@letho1608 letho1608 requested a review from a team as a code owner March 25, 2026 22:12
@letho1608 letho1608 requested review from ValentinaKats and removed request for a team March 25, 2026 22:12
@github-actions github-actions bot added the category: docs OpenVINO documentation label Mar 25, 2026
@sys-openvino-ci sys-openvino-ci added the ExternalPR External contributor label Mar 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

category: docs OpenVINO documentation ExternalPR External contributor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: readme lacks installation and usage guidance

2 participants