Skip to content

docs: centralize shared community files #5

Closed

Description

@Jammy2211

Overview

Make PyAutoScientist the canonical home for PyAutoLabs-wide community policy,
replacing drift-prone copies with short links. Use the existing public
PyAutoLabs/.github repository as GitHub's organization-wide distribution layer,
and remove local templates that unnecessarily override its shared forms.

Plan

  • Add canonical Code of Conduct and contribution guidance to PyAutoScientist.
  • Replace existing repository copies with uniform pointers.
  • Use PyAutoLabs/.github to cover repositories without local overrides.
  • Preserve distinct library, workspace, and organism contribution workflows.
  • Remove duplicated local issue templates so organization defaults apply.
  • Validate links and record adjacent policies suitable for later centralization.
Detailed implementation plan

Work Classification

Workspace documentation

Affected Repositories

  • PyAutoScientist (primary)
  • .github
  • HowToFit
  • HowToGalaxy
  • HowToLens
  • PyAutoArray
  • PyAutoBrain
  • PyAutoCTI
  • PyAutoFit
  • PyAutoGalaxy
  • PyAutoHands
  • PyAutoHeart
  • PyAutoLens
  • PyAutoMemory
  • PyAutoMind
  • PyAutoNerves
  • autocti_workspace
  • autofit_workspace
  • autofit_workspace_test
  • autogalaxy_workspace
  • autolens_workspace
  • autolens_workspace_test

Branch Survey

Most repositories are clean on main.

Known coordination state:

  • PyAutoBrain is claimed by hygiene-adjacent-docstrings.
  • PyAutoHands is claimed by notebook-adjacent-docstrings.
  • PyAutoCTI and PyAutoFit are claimed by testmode-env-drift.
  • PyAutoMemory has an unrelated reading-queue.md modification.
  • autolens_workspace has unrelated start_here.py and notebook changes.
  • PyAutoMind is on feature/mind-lifecycle-auto-index; the new task prompt is
    currently untracked there.

Suggested branch: feature/central-community-docs

Worktree root: ~/Code/PyAutoLabs-wt/central-community-docs/ (created once
the existing claims clear)

Implementation Steps

  1. Add PyAutoScientist/CODE_OF_CONDUCT.md, using the existing organization
    Contributor Covenant 2.1 policy as the base, with PyAutoLabs-wide scope and
    an explicit private reporting route.
  2. Add PyAutoScientist/CONTRIBUTING.md, reconciling external contribution
    guidance with the distinct library, workspace, and living-organism
    development models. Replace stale PyAutoPrompt references with PyAutoMind.
  3. Replace .github/CODE_OF_CONDUCT.md and .github/CONTRIBUTING.md with
    concise links to the PyAutoScientist canonical documents.
  4. Replace the existing full local copies across the affected repositories with
    uniform pointer files. Repositories without local overrides will inherit the
    organization defaults automatically.
  5. Remove identical legacy bug and feature templates from PyAutoArray,
    PyAutoFit, PyAutoGalaxy, PyAutoLens, PyAutoNerves, autofit_workspace,
    autogalaxy_workspace, and autolens_workspace so the organization YAML forms
    take effect.
  6. Verify the inventory, links, absence of stale workflow references, and
    absence of remaining full policy duplicates.
  7. Keep licenses and scientific citation guidance local. Leave the AI statement
    content for its own task; record SECURITY.md, SUPPORT.md, and GOVERNANCE.md
    as future candidates for the same architecture.

Key Files

  • PyAutoScientist/CODE_OF_CONDUCT.md
  • PyAutoScientist/CONTRIBUTING.md
  • .github/CODE_OF_CONDUCT.md
  • .github/CONTRIBUTING.md
  • Existing repository-root policy files in the affected repositories
  • Existing duplicated .github/ISSUE_TEMPLATE/{bug_report,feature_request}.md
    files in the eight overriding repositories

Original Prompt

Click to expand starting prompt

The repos all share and duplicate CODE_OF_CONDUCT.md, CONTRIBUTING.md, can we
move their up to PyAutoScientist and have each repo level on just direct to that?
We will add an AI STATEMENT next which follows the same logic. Check if anything
else falls in this remit

Activity

  1. Jammy2211 commented on Jul 27, 2026

    @Jammy2211
    ContributorAuthor

    Implementation PRs opened — 2026-07-27

    Canonical and organization defaults

    Libraries and organs

    Workspaces and tutorials

    Summary

    PyAutoScientist now contains the canonical Contributor Covenant 2.1 Code of Conduct and shared contribution guide. Existing repository copies are uniform pointers, and 16 duplicated Markdown issue templates were removed so the organization YAML issue forms can be inherited.

    Validation

    • Review faculty: CLEAN after one wording correction.
    • All 15 Code of Conduct pointers and 18 contribution pointers are internally identical.
    • No legacy issue-template files remain in the eight overriding repositories.
    • All 22 PRs target main, carry pending-release, and reference this issue.
    • Runtime tests were not run because no source, test, script, notebook, or runtime configuration files changed.

    The PRs are open and awaiting human merge decisions. PyAutoScientist#6 should merge before the pointer PRs so their canonical links resolve immediately.

  2. Jammy2211 commented on Jul 27, 2026

    @Jammy2211
    ContributorAuthor

    Shipped — 2026-07-27

    PRs

    All 22 coordinated PRs are merged. The full repository-by-repository matrix is recorded in the implementation comment.

    Primary PR: #6

    Summary

    PyAutoScientist is now the canonical home for the PyAutoLabs Contributor Covenant 2.1 Code of Conduct and shared contribution guide. Fifteen Code of Conduct files and eighteen contribution files now act as uniform pointers, while sixteen duplicated Markdown issue templates were removed so repositories inherit the organization YAML forms.

    Session Notes

    • The canonical PR was merged first; both canonical policy URLs returned HTTP 200 before any pointer PR was merged.
    • Review faculty verdict: CLEAN after correcting one over-broad claim about every repository having an AGENTS.md.
    • All reported CI checks passed, including the final four-job autolens_workspace_test smoke matrix.
    • No runtime files changed. The earlier Heart YELLOW reasons were acknowledged as unrelated organism-wide state.
    • A future AI_STATEMENT.md can use the same canonical-document plus pointer structure. SECURITY.md, SUPPORT.md, and GOVERNANCE.md remain future centralization candidates.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions