Skip to content

docs: instantiate PLC OSS template skeleton and pull sibling files - #5

Merged
nvankita merged 3 commits into
mainfrom
docs/readme-from-plc-template
May 15, 2026
Merged

nvankita merged 3 commits into
mainfrom
docs/readme-from-plc-template

Conversation

@nvankita

Copy link
Copy Markdown
Collaborator

Summary

Apply the PLC-OSS-Template's own customization steps to this repo's bootstrapped README, then pull the sibling files the new README references but which weren't present in the repo.

Commits

2d0ee8bdocs(README): instantiate PLC OSS template skeleton

  • Step 5 of the template's usage guide: remove the meta-instructions section ending at <!-- REMOVE THE LINE BELOW AND EVERYTHING ABOVE -->.
  • Step 2 placeholder substitution: [Project Title]DeepStream.
  • Align LICENSE reference with PLC convention: LICENSE.mdLICENSE.

Net diff on README.md: 86 lines → 70 lines (-85, +1).

Content placeholders inside the project skeleton (<copy-paste install>, <TEAM>, <link>, <Experimental | Maintained | Stable>, etc.) and the GOVERNANCE.md reference are intentionally left as TODOs — those need real project-specific values, not template substitution.

df32d32docs: add PLC OSS template sibling files (LICENSE, CONTRIBUTING, CODE_OF_CONDUCT)

File Source Substitutions
LICENSE PLC template Apache 2.0 none (verbatim)
CONTRIBUTING.md PLC template __PROJECT__DeepStream, rapidsaiNVIDIA
CODE_OF_CONDUCT.md PLC template __PROJECT__DeepStream

Known TODOs left intact

Mechanical substitution scope was limited per the "placeholder substitution only" mode chosen during review. The following follow-ups remain visible in the tree and should be cleaned up in a separate PR:

  1. CONTRIBUTING.md lines 10, 33–34, 39, 52, 60 — six RAPIDS-with-capital references and two external RAPIDS-specific URLs (jarmak-nv/rapids-repo-template, docs.rapids.ai/api/cudf) that the lowercase rapidsai substitution didn't catch.
  2. CONTRIBUTING.md:52 and :57 — after substitution these became github.com/NVIDIA/kb/issues/42 and github.com/orgs/NVIDIA/projects/80, which don't exist. Need real DeepStream-team-owned labels/board references.
  3. README.md Governance section references GOVERNANCE.md, which is not present in the PLC template. Per repo-admin direction, the reference stays as a TODO rather than a stub file.
  4. .github/ directory currently only contains .gitkeep — PLC template's CODEOWNERS, PULL_REQUEST_TEMPLATE.md, ISSUE_TEMPLATE/, and workflow-templates/ are not yet imported. Out of scope here.

Audit of repo vs PLC template

  • SECURITY.md (already in repo) — byte-identical to PLC template ✅
  • README.md — was template; now instantiated.
  • LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md — added in this PR.
  • Still missing from PLC template (not strictly required by README): CITATION.md, CHANGELOG.md, CLA.md, print_env.sh, .github/CODEOWNERS, .github/PULL_REQUEST_TEMPLATE.md, .github/ISSUE_TEMPLATE/, .github/workflow-templates/, .github/folder_README.md.

nvankita and others added 2 commits May 15, 2026 11:01
Apply the PLC-OSS-Template's own customization steps to the bootstrapped
README:
- Step 5 (remove meta-instructions section ending at `<!-- REMOVE THE
  LINE BELOW AND EVERYTHING ABOVE -->`)
- Step 2 placeholder substitution: `[Project Title]` -> `DeepStream`
- Align LICENSE reference with PLC convention (`LICENSE.md` -> `LICENSE`)

Content placeholders inside the project skeleton (`<copy-paste install>`,
`<TEAM>`, `<link>`, `<Experimental | Maintained | Stable>`, etc.) and
the `GOVERNANCE.md` reference are intentionally left as TODOs - those
need real project-specific values, not template substitution.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Committed-By: ankitat's Claude Agent
Codex Review: Approved:
…_OF_CONDUCT)

The new README references CONTRIBUTING.md, CODE_OF_CONDUCT.md, and
LICENSE; none existed in the repo. Pulled all three from the PLC OSS
template (github.com/NVIDIA-GitHub-Management/PLC-OSS-Template):

- `LICENSE`: Apache 2.0, copied verbatim.
- `CONTRIBUTING.md`: `__PROJECT__` -> `DeepStream`, `rapidsai` -> `NVIDIA`.
- `CODE_OF_CONDUCT.md`: `__PROJECT__` -> `DeepStream`.

Known TODOs left intact (out of scope for the mechanical substitution):
- `CONTRIBUTING.md` lines 10, 33-34, 39, 52, 60: six `RAPIDS`-with-capital
  references and two RAPIDS-specific external URLs (jarmak-nv/rapids-
  repo-template, docs.rapids.ai/api/cudf) that the literal `rapidsai`
  substitution didn't catch.
- `CONTRIBUTING.md:52` and `:57`: after substitution, links point at
  `NVIDIA/kb/issues/42` and `orgs/NVIDIA/projects/80` - non-existent
  targets; need a separate cleanup pass with real DeepStream-team
  references.
- `GOVERNANCE.md`: referenced in README but not present in the PLC
  template; reference left as a TODO per repo-admin direction.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Committed-By: ankitat's Claude Agent
Codex Review: Approved:
@nvankita nvankita self-assigned this May 15, 2026
@nvankita
nvankita requested a review from nvapandya May 15, 2026 05:33
…files

Per review feedback on PR #5:

Removed:
- CONTRIBUTING.md (per request - leave dropped from this PR)
- skills/ (empty placeholder dir, only contained .gitkeep)
- .github/.gitkeep (no longer needed - .github/ now has real content)

README.md edits:
- Contribution Guidelines section -> "This project is currently not
  accepting contributions." (drop Start here/CoC/quickstart bullets)
- License section: drop `- License: <link>` line, add
  `- SPDX-License-Identifier: Apache-2.0`

Added remaining PLC OSS template files (skipping CLA.md per request),
with `__PROJECT__`/`___PROJECT___` -> `DeepStream` and `rapidsai` ->
`NVIDIA` substitutions where applicable:
- CITATION.md (verbatim - no placeholders)
- CHANGELOG.md
- print_env.sh (executable)
- .github/CODEOWNERS
- .github/PULL_REQUEST_TEMPLATE.md
- .github/folder_README.md (verbatim)
- .github/ISSUE_TEMPLATE/{bug_report,bug_report_form,config,
  documentation-request,documentation_request_correction,
  documentation_request_new,feature_request,feature_request_form,
  submit-question}.{md,yml}
- .github/workflow-templates/{add_issue_to_project,
  add_issue_to_project_raw}.yml

Known TODOs left intact (out of scope for mechanical substitution):
- .github/CODEOWNERS: `<org>` and `<repo>` placeholders unset
- .github/PULL_REQUEST_TEMPLATE.md: links to CONTRIBUTING.md which was
  removed in this PR
- CITATION.md: still contains generic `Project_Name`/`Project_url`
  example tokens from upstream template
- README.md: `<TEAM>`, `<link>`, etc. content placeholders and
  GOVERNANCE.md reference remain as TODOs

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Committed-By: ankitat's Claude Agent
Codex Review: Approved:
@nvankita

Copy link
Copy Markdown
Collaborator Author

New commit: 7bf028a — docs: address PR review - drop CONTRIBUTING.md, fill out PLC sibling files

What changed:

  • Removed CONTRIBUTING.md (per request), skills/ (empty placeholder dir), .github/.gitkeep (no longer needed)
  • README: Contribution Guidelines section → This project is currently not accepting contributions.; License section → dropped - License: <link>, added - SPDX-License-Identifier: Apache-2.0
  • Added remaining PLC template files (skipping CLA.md per request): CITATION.md, CHANGELOG.md, print_env.sh, .github/CODEOWNERS, .github/PULL_REQUEST_TEMPLATE.md, .github/folder_README.md, .github/ISSUE_TEMPLATE/ (9 files), .github/workflow-templates/ (2 files)
  • Applied same substitutions as before: __PROJECT__ / ___PROJECT___DeepStream, rapidsaiNVIDIA

Local validation:

  • grep -rln '__PROJECT__\|___PROJECT___\|rapidsai' CITATION.md CHANGELOG.md print_env.sh .github/ → no matches ✅ (all target placeholders substituted in the new files)

Known TODOs left intact (out of scope for mechanical substitution; flagged for follow-up):

  • .github/CODEOWNERS still has <org> / <repo> placeholders
  • .github/PULL_REQUEST_TEMPLATE.md links to CONTRIBUTING.md, which was removed in this PR
  • CITATION.md retains upstream Project_Name / Project_url example tokens
  • README.md still has <TEAM> / <link> content placeholders and the GOVERNANCE.md reference

Current CI state:

  • No checks configured for this repo yet (workflow-templates added in this commit are not yet wired into .github/workflows/)

Link: #5

@nvapandya nvapandya left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

[PLC-OSS-Template] clone files looks ok. will need to review further for custom updates for DeepStream

@nvankita
nvankita merged commit 00f73b5 into main May 15, 2026
@nvankita
nvankita deleted the docs/readme-from-plc-template branch May 15, 2026 09:24
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.

2 participants