Skip to content

docs: slim down README and fix SECURITY.md#96

Merged
KT-Doan merged 1 commit intomainfrom
docs/cleanup-readme-security
Mar 6, 2026
Merged

docs: slim down README and fix SECURITY.md#96
KT-Doan merged 1 commit intomainfrom
docs/cleanup-readme-security

Conversation

@KT-Doan
Copy link
Collaborator

@KT-Doan KT-Doan commented Mar 6, 2026

Description

Slim down README to avoid constant maintenance when resources are added/changed. Fix SECURITY.md to include vulnerability reporting instructions and remove incorrect version table.

Related Issues

N/A

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update

Checklist

  • I have read the CONTRIBUTING guide
  • My code follows the existing code style
  • I have added tests that prove my fix/feature works
  • I have updated documentation as needed
  • All new and existing tests pass (make test)
  • I have run the linter (make format)

Testing

  • Unit tests
  • Acceptance tests
  • Manual testing

N/A — documentation-only changes.

Screenshots/Output

README changes

  • Removed duplicated content already in CONTRIBUTING.md (testing, setup, pre-commit checklist, security scanning, doc templates)
  • Removed feature/resource lists and extra examples that require updating whenever resources change
  • Fixed Quick Start: added missing required provider_type on ory_social_provider, normalized duration format (720h0m0s)
  • Points users to Terraform Registry docs and examples/ for full resource documentation

SECURITY.md changes

  • Added "Reporting Vulnerabilities" section (was missing entirely)
  • Removed "Supported Versions" table that listed 0.1.x (latest release is v0.0.5)

- Remove duplicated content from README that already exists in
  CONTRIBUTING.md (testing, setup, pre-commit, security scanning,
  documentation templates)
- Remove feature/resource lists and extra examples that require
  constant updating when resources change
- Keep README focused: installation, authentication, quick start
- Fix Quick Start example: add missing required provider_type field
  on ory_social_provider, use normalized duration format (720h0m0s)
- Point users to Terraform Registry docs and examples/ for full
  resource documentation
- Add missing "Reporting Vulnerabilities" section to SECURITY.md
- Remove incorrect supported version table (listed 0.1.x, latest
  is v0.0.5)
Copilot AI review requested due to automatic review settings March 6, 2026 07:44
@KT-Doan KT-Doan self-assigned this Mar 6, 2026
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

Documentation-focused update to reduce ongoing README maintenance burden and correct the repository’s security policy guidance for vulnerability reporting.

Changes:

  • Simplified README.md by removing large, frequently-changing feature/resource listings and pointing readers to Terraform Registry docs and examples/.
  • Updated README Quick Start snippets to include required provider_type for ory_social_provider and normalized duration formatting (720h0m0s).
  • Reworked SECURITY.md by removing an incorrect supported-versions table and adding explicit vulnerability reporting instructions.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
SECURITY.md Removes incorrect supported-versions content and adds a clear vulnerability reporting process.
README.md Streamlines documentation, fixes Quick Start examples, and points users to canonical docs/examples to reduce maintenance.

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

@KT-Doan KT-Doan merged commit a9a3cb0 into main Mar 6, 2026
16 checks passed
@KT-Doan KT-Doan deleted the docs/cleanup-readme-security branch March 6, 2026 07:55
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.

3 participants