Skip to content

Update README with project description, docs links, and centered logo#49

Merged
toddysm merged 1 commit intomainfrom
feature/readme
Mar 14, 2026
Merged

Update README with project description, docs links, and centered logo#49
toddysm merged 1 commit intomainfrom
feature/readme

Conversation

@toddysm
Copy link
Owner

@toddysm toddysm commented Mar 14, 2026

Summary

Overhauls the repository README to better describe the project, link to specs and documentation, and improve the visual layout.

Closes #48

Changes

Visual Layout

  • Centered the RegShape chameleon logo using <p align="center"> with width="256"
  • Kept existing GitHub badges (issues, PRs) at the top, unchanged

Project Description

  • Fixed the OCI link typo (opencoutnaiers.orgopencontainers.org)
  • Clarified RegShape's dual-mode usage:
    • Standard mode — interact with registries normally (manifests, blobs, tags, etc.)
    • Expert / break mode — craft custom requests to test registry implementations
  • Highlighted the bold portions of the REGistry reSHAPE name origin

New Sections

  • Installation — clone + pip install -e . (pip install not yet available)
  • Quick Start — example commands for ping, manifest get, and tag list
  • Documentation — links to:
    • Guides (OCI Layouts, Docker Desktop Integration)
    • Architecture overview
    • CLI command specs (table with all 10 commands)
    • Library specs (Models, Operations)
  • Contributing — links to CONTRIBUTING.md
  • Security — links to SECURITY.md
  • License — links to LICENSE (Apache 2.0)

Retained

  • Early development / API not stable disclaimer (now as blockquote)

…d install instructions

- Center the chameleon logo using HTML <p align="center">
- Fix OCI link typo (opencoutnaiers.org -> opencontainers.org)
- Clarify dual-mode usage: standard mode and expert/break mode
- Add Installation section (clone + pip install -e .)
- Add Quick Start section with ping, manifest get, and tag list examples
- Add Documentation section linking to guides, architecture, CLI specs, and library specs
- Add Contributing, Security, and License sections
- Retain early development disclaimer

Closes #48
Copilot AI review requested due to automatic review settings March 14, 2026 03:12
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR overhauls the repository README to provide a clearer project description, fix a typo in the OCI link, center the logo, and add Installation, Quick Start, Documentation, Contributing, Security, and License sections. It closes issue #48.

Changes:

  • Fixed OCI URL typo and improved project description with dual-mode explanation and bold name-origin highlights
  • Centered the logo using HTML and added new sections (Installation, Quick Start, Documentation, Contributing, Security, License)
  • Added a Documentation section with links to guides, architecture, CLI command specs (table), and library specs

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@toddysm toddysm merged commit 04baffe into main Mar 14, 2026
7 checks passed
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

Successfully merging this pull request may close these issues.

Update README with project description, docs links, and centered logo

2 participants