Skip to content

docs(ospo): community health rollout v2 — README, agents.md, health files#13815

Open
dj4oC wants to merge 6 commits into
masterfrom
ospo/community-health-v2
Open

docs(ospo): community health rollout v2 — README, agents.md, health files#13815
dj4oC wants to merge 6 commits into
masterfrom
ospo/community-health-v2

Conversation

@dj4oC

@dj4oC dj4oC commented May 28, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR is part of the Kiteworks OSPO community health rollout (kiteworks.com/opensource), applied to all ~110 public ownCloud repositories starting May 5, 2026.

  • README.md: Rewritten with v2 OSPO template
    • License-specific OSPO section with Apache 2.0 migration guidance
    • Mandatory Community & Support section: GitHub Discussions, Matrix, docs, enterprise support, OSPO home
    • Contributing workflow: Rebase Early/Often, Dependabot, PGP/GPG-signed commits, DCO sign-off, GitHub Actions policy
    • Security section pointing to security.owncloud.com + YesWeHack bug bounty
    • Translations link to Transifex (owncloud project)
  • agents.md (new): AI agent context file with architecture, build commands, OSPO policy constraints
  • CODE_OF_CONDUCT.md (new): Redirect to https://owncloud.com/contribute/code-of-conduct/
  • CONTRIBUTING.md (new): Redirect to https://owncloud.com/contribute/
  • SECURITY.md (new): Redirect to https://security.owncloud.com + YesWeHack
  • SUPPORT.md (new): Redirect to https://owncloud.com/contact-us/ and support channels

Test plan

  • README renders correctly on GitHub (badges, sections, links)
  • All health file links resolve (CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, SUPPORT)
  • agents.md loads correctly in Claude Code and GitHub Copilot
  • License referenced in README matches actual LICENSE file in repo

🤖 Generated with Claude Code as part of the ownCloud OSPO rollout.
Kiteworks OSPO: https://kiteworks.com/opensource

…iles

Introduced by the Kiteworks Open Source Program Office (OSPO) on May 5, 2026.

Changes:
- README.md: rewritten with OSPO v2 template — license-specific migration
  guidance, Community & Support section, Contributing workflow, Security
  section pointing to security.owncloud.com + YesWeHack bug bounty
- agents.md: AI agent context file with architecture, build commands, and
  OSPO Policy Constraints (GitHub Actions, Dependabot, Git Workflow)
- CODE_OF_CONDUCT.md: redirect to https://owncloud.com/contribute/code-of-conduct/
- CONTRIBUTING.md: redirect to https://owncloud.com/contribute/
- SECURITY.md: redirect to https://security.owncloud.com + YesWeHack
- SUPPORT.md: redirect to https://owncloud.com/contact-us/ + channels

OSPO: https://kiteworks.com/opensource

Signed-off-by: David Walter <david.walter@kiteworks.com>
@update-docs

update-docs Bot commented May 28, 2026

Copy link
Copy Markdown

Thanks for opening this pull request! The maintainers of this repository would appreciate it if you would create a changelog item based on your changes.

@dj4oC dj4oC requested review from DeepDiver1975 and kobergj May 28, 2026 08:08
dj4oC added a commit that referenced this pull request Jun 1, 2026
@kw-security

kw-security commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues
Code Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Satisfies the update-docs[bot] request on #13815 (comment)
Signed-off-by: David Walter <david.walter@kiteworks.com>
@dj4oC dj4oC force-pushed the ospo/community-health-v2 branch from 9aff133 to f9d2e51 Compare June 2, 2026 06:26
DeepDiver1975 added a commit to owncloud/marketplace that referenced this pull request Jun 12, 2026
…iles, Apache-2.0 (#10)

docs(ospo): add community health files and Apache-2.0 license

Apply the Kiteworks OSPO community health rollout v2 to this repository
(modeled on owncloud/web#13815), adapted to the static, PR-based
marketplace:

- LICENSE: Apache-2.0 (adopt the OSPO migration target directly)
- README.md: OSPO v2 rewrite describing the marketplace, publishing
  workflow, generated API, OSPO contributing policy and OSPO section
- agents.md: AI-agent context file with architecture, build/test
  commands and OSPO policy constraints
- CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, SUPPORT.md: standard
  health files pointing to ownCloud channels and YesWeHack
- Pin all GitHub Actions to full commit SHAs (with version comments) per
  OSPO policy, keeping the current major versions
- Declare "license": "Apache-2.0" in tools/ and website/ package.json

Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
DeepDiver1975 added a commit to owncloud-docker/server that referenced this pull request Jun 12, 2026
Incorporate the Kiteworks OSPO community health rollout v2 (adapted from
owncloud/web#13815) into this repository, with all repo-specific facts
replaced to match this Docker image build repo (MIT license, Dockerfile +
overlay layout, GitHub Actions build) rather than the web frontend.

- README.md: append Community & Support, Contributing, Security and
  About the ownCloud OSPO sections plus an OSPO badge (additive — the
  existing Docker reference is kept since it is synced to Docker Hub)
- agents.md: new AI-agent context file describing the Docker build,
  overlay structure, CI and OSPO policy
- CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, SUPPORT.md: new
  community health files
- CHANGELOG.md: dated entry following the existing convention

The OSPO/license section is adapted to MIT (permissive, already
Apache-2.0 compatible) — the AGPL copyleft-migration prerequisites from
the source PR do not apply here.

Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@dj4oC dj4oC requested a review from LukasHirt June 13, 2026 12:28
Comment thread changelog/unreleased/enhancement-ospo-community-health-files.md Outdated
Comment thread README.md
dj4oC and others added 2 commits June 19, 2026 21:54
- remove the changelog item (docs-only change; changelog is for user-facing
  code changes per maintainer feedback)
- drop the redundant 'Development Setup' clone/install/build snippet from the
  README; the canonical setup guide is already linked, and keep Prerequisites

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: David Walter <david.walter@kiteworks.com>
Per review: the clone/install/build block duplicated the linked setup guide.
Keep Prerequisites and the setup-guide link.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: David Walter <david.walter@kiteworks.com>
@dj4oC dj4oC enabled auto-merge June 23, 2026 03:00
@dj4oC

dj4oC commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jun 25, 2026

Copy link
Copy Markdown

@copilot resolve the merge conflicts in this pull request

Done — merged master into the branch and resolved the README.md conflict (kept the OSPO version of the "Part of oCIS" paragraph). The branch is now up to date with master and all health files are intact.

@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ dj4oC
❌ Copilot
You have signed the CLA already but the status is still pending? Let us recheck it.

Copilot finished work on behalf of dj4oC June 25, 2026 20:32
@sonarqubecloud

Copy link
Copy Markdown

@DeepDiver1975 DeepDiver1975 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks for the community-health rollout, David — this is consistent with the v2 pattern landed in docs-ocis#1260, docs-ui#1009, and docs-webui#214. New CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, SUPPORT.md, and agents.md all read well, the OSPO/relicensing section is accurate, and the in-repo references (LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md) resolve. I verified the external links — kiteworks.com/opensource, security.owncloud.com, the two owncloud.com/contribute/* pages, Transifex, YesWeHack, doc.owncloud.com, and owncloud.dev all return 200.

Two link issues worth fixing before this goes in:

  1. Broken Docker pulls badge (README header). https://img.shields.io/docker/pulls/owncloud renders 404: badge not found — the shields docker/pulls endpoint requires user/repo. Please use https://img.shields.io/docker/pulls/owncloud/web (that one correctly renders "docker pulls: 118k"). The badge link target (https://hub.docker.com/r/owncloud/web) is already correct.

  2. https://demo.owncloud.com/ (Live Demo) returns 404. The new README re-asserts this prominently under "Part of oCIS" and again under "Community & Support". Please point it at a live demo URL or drop the line.

Minor (non-blocking): agents.md lists packages/design-system and the app packages but omits a few that exist in the tree (web-app-ocm, web-app-app-store, web-app-webfinger, web-app-password-protected-folders, web-app-epub-reader, web-app-search); not worth holding the PR for, but worth a follow-up if the file is meant to be exhaustive.

No changelog fragment is needed here — these are OSPO/community-health meta files, not app-facing changes (changelog=n-a), matching the rest of the rollout.

Heads-up on merge readiness: the license/cla check is currently pending ("Contributor License Agreement is not signed yet"), so the PR is BLOCKED. Once the CLA is signed and the two link fixes above are in, this is good to go.

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.

6 participants