Skip to content

chore: update README#8284

Merged
grantfitzsimmons merged 4 commits into
mainfrom
update-readme
Jul 9, 2026
Merged

chore: update README#8284
grantfitzsimmons merged 4 commits into
mainfrom
update-readme

Conversation

@grantfitzsimmons

@grantfitzsimmons grantfitzsimmons commented Jul 8, 2026

Copy link
Copy Markdown
Member

This updates our README.md... quite a bit!

Added:

  • Table of Contents with anchor links
  • Data ownership paragraph (full ownership, no vendor lock-in, data sovereignty)
  • Detailed descriptions for all 4 Specify components (Specify 7, Worker, Asset Server, Report Runner)
  • Architecture documentation link under Tech Stack
  • Links to community docs for Asset Server (3 links) and Report Runner (1 link)

Changed:

  • Self-hosted section now states Docker/Podman is the only supported production method

Removed:

  • Entire Local Installation section (~400 lines of bare-metal install: Apache, Python venv, Specify 6, updating instructions)

Summary by CodeRabbit

  • Documentation
    • Refreshed the README with a shorter, more polished overview of Specify 7 and the collections management platform.
    • Streamlined the installation guidance to highlight Specify Cloud (recommended), plus self-hosted Docker/Podman and a brief development setup note.
    • Added a simplified tech stack section describing the main platform components.
    • Updated the table of contents and condensed the footer/funding and licensing text to match the new scope.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown

Warning

One or more dependencies are approaching or past End-of-Life.
Please plan upgrades accordingly.

STATUS=WARNING
NODE_VERSION=20
NODE_CYCLE=20
EOL_DATE=2026-04-30
DAYS_REMAINING=-70

--- Node.js ---
Version: 20
EOL: 2026-04-30
Status: WARNING

STATUS=OK
PYTHON_VERSION=3.12
PYTHON_CYCLE=3.12
EOL_DATE=2028-10-31
DAYS_REMAINING=845

--- Python ---
Version: 3.12
EOL: 2028-10-31
Status: OK

STATUS=WARNING
DJANGO_VERSION=4.2
DJANGO_CYCLE=4.2
EOL_DATE=2026-04-07
DAYS_REMAINING=-93

--- Django ---
Version: 4.2
EOL: 2026-04-07
Status: WARNING


@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1619bf73-e2b6-47db-a9ae-7f69ce919673

📥 Commits

Reviewing files that changed from the base of the PR and between 347018f and 15b9d00.

📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

README.md was rewritten to shorten the product overview, reduce installation detail, add a simplified tech stack and component summary, and replace the footer with a condensed funding line. No exported code changed.

Changes

README Condensation

Layer / File(s) Summary
Intro and table of contents
README.md
Introduction is replaced with a logo and condensed platform overview; the table of contents is shortened to match the reduced scope.
Installation and tech stack sections
README.md
Detailed Docker/local installation steps are replaced with brief Specify Cloud, self-hosted, and development setup sections plus a simplified tech stack list.
Components overview and footer
README.md
Deployment/component documentation is condensed into a Specify Components section and the footer is replaced with a condensed funding credit line.
🚥 Pre-merge checks | ✅ 5 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Testing Instructions ⚠️ Warning No actionable testing steps are provided; the PR template asks for them, but this PR only has a vague dev-setup note and no verification coverage for the added README content/components. Add a Testing instructions section with concrete, component-specific verification steps (e.g., check anchors/links, self-hosted wording, and component doc links) or note that no code testing is needed.
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main change: a substantial README update.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Automatic Tests ✅ Passed PR is README-only; latest commit changes only README.md, so automatic tests were not necessary.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch update-readme

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 67: The contributing-guide link in README is pointing to a non-existent
relative target, so update the link in the README text to reference the actual
guide location or a valid anchor. Use the existing “guide to contributing code
to Specify” link text and adjust only the destination so it resolves correctly
when users click it.
- Line 15: The accessibility wording in the README is too absolute and reads
like a formal compliance claim; update the copy in the README section that
mentions WCAG 2.1 (AA) to either point to a published accessibility audit/report
or rephrase it more cautiously. Adjust the text around the accessibility
description so it avoids asserting “largely complies” unless there is a cited
source, and keep the language aligned with the existing product description.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: ffd78f53-e575-49cd-b93f-a0eca3535e06

📥 Commits

Reviewing files that changed from the base of the PR and between 5753746 and 347018f.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
Comment thread README.md Outdated
@github-project-automation github-project-automation Bot moved this from 📋Back Log to Dev Attention Needed in General Tester Board Jul 8, 2026
@grantfitzsimmons grantfitzsimmons merged commit f5ee1e8 into main Jul 9, 2026
20 checks passed
@grantfitzsimmons grantfitzsimmons deleted the update-readme branch July 9, 2026 14:43
@github-project-automation github-project-automation Bot moved this from Dev Attention Needed to ✅Done in General Tester Board Jul 9, 2026
@CarolineDenis CarolineDenis added this to the 7.12.1 milestone Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅Done

Development

Successfully merging this pull request may close these issues.

2 participants