Skip to content

docs(readme): add documentation to follow OSS standards#97

Merged
JustinZhang17 merged 10 commits intomainfrom
docs/43-readme-wiki
Jun 30, 2025
Merged

docs(readme): add documentation to follow OSS standards#97
JustinZhang17 merged 10 commits intomainfrom
docs/43-readme-wiki

Conversation

@JustinZhang17
Copy link
Copy Markdown
Member

Proposed Changes/Description

  • To follow OSS standards
  • Add Contribution guide
  • Update Readme with volume cleaner details
  • Add Code of Conduct
  • Add Security Policy
  • Add French translation

Types of Changes

What types of changes does your code introduce to volume-cleaner? Put an x in the boxes that apply

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation Update
  • Other (if none of the other choices apply)

Testing

Look at CONTRIBUTING.md, README.md, CODE_OF_CONDUCT.md, and SECURITY.md

Screenshots (if applicable)

N/A

Related Issue/Ticket

Closes #43

Checklist

  • README.md or the Github Wiki documentation updated - if appropriate
  • Unit and/or integration tests added/modified
  • Lint and Unit tests pass locally with my changes

This changes adds a code of conduct, contributing guide, license, and
restructures some of the project's readme
This change adds draft french translations, furthermore, the README.md
is populated with details such as volume cleaner's features,
requirements along with deepwiki and license badges.
@JustinZhang17 JustinZhang17 requested a review from Copilot June 26, 2025 19:11
@JustinZhang17 JustinZhang17 self-assigned this Jun 26, 2025
@JustinZhang17 JustinZhang17 added the documentation Improvements or additions to documentation label Jun 26, 2025

This comment was marked as outdated.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@JustinZhang17 JustinZhang17 requested a review from Copilot June 26, 2025 19:13
Copy link
Copy Markdown
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

Adds comprehensive OSS documentation, including contribution guidelines, security policy, code of conduct, and French translations to align with open-source standards

  • Introduce CONTRIBUTING.md and enrich README.md with project overview, features, and Translations
  • Add SECURITY.md and CODE_OF_CONDUCT.md with English and French sections
  • Provide French translations across documentation

Reviewed Changes

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

File Description
SECURITY.md Added security reporting instructions in both English and French
README.md Expanded introductory sections, features, quick start, and added French translation
CONTRIBUTING.md Created detailed contribution guide with English and French versions
CODE_OF_CONDUCT.md Added CNCF Code of Conduct reference and French translation
Comments suppressed due to low confidence (3)

README.md:71

  • The Quick Start section is currently empty; consider adding setup instructions or removing the placeholder to avoid confusion.
## Quick Start

README.md:95

  • [nitpick] The French section does not include a link back to the English section. Consider adding an '(English)' link at the top for easier navigation.
# Volume Cleaner Kubernetes

SECURITY.md:1

  • [nitpick] The anchor '#sécurité' may not resolve correctly due to the accented character. Consider using an ASCII-only anchor (e.g., '#securite') or verifying link rendering.
([Français](#sécurité))

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Comment thread CODE_OF_CONDUCT.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
Comment thread README.md
Comment thread README.md
@JustinZhang17 JustinZhang17 requested a review from anrayliu June 27, 2025 15:12
Comment thread CONTRIBUTING.md Outdated
@JustinZhang17 JustinZhang17 requested a review from anrayliu June 27, 2025 19:17
Copy link
Copy Markdown
Collaborator

@anrayliu anrayliu left a comment

Choose a reason for hiding this comment

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

lgtm

@JustinZhang17 JustinZhang17 merged commit fd4784c into main Jun 30, 2025
13 checks passed
@JustinZhang17 JustinZhang17 deleted the docs/43-readme-wiki branch June 30, 2025 13:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: updating README and GH wiki with latest contribution practices/guide

3 participants