Skip to content

Org templates, governance, and reusable lint workflow#1

Merged
mshafiee merged 1 commit into
mainfrom
feat/org-templates-and-lint
Jul 20, 2026
Merged

Org templates, governance, and reusable lint workflow#1
mshafiee merged 1 commit into
mainfrom
feat/org-templates-and-lint

Conversation

@mshafiee

Copy link
Copy Markdown
Contributor

Scope

Cross-cutting governance + tooling in the org .github repo. These become org-wide defaults for every repo that doesn't override them.

Changes

  • Issue templates: bug_report.yml, feature_request.yml (bilingual fa/en note), config.yml (blank issues disabled; contact links to website, spec docs, security policy).
  • PULL_REQUEST_TEMPLATE.md — spec-alignment + hard-constraint reminders (Debian 13 amd64-only, Plasma 6.7 Wayland-default, non-free on, Vazirmatn, ISIRI 9147 + ZWNJ, Asia/Tehran + Jalali) + bilingual note.
  • CONTRIBUTING.md — spec map, repo map, branch model (trunk-based), conventions (shell/TS/bilingual UX), and the lint opt-in pattern.
  • CODE_OF_CONDUCT.md — Contributor Covenant 2.1 (enforcement: conduct@zurvanlinux.org).
  • SECURITY.md — private reporting (GitHub Private Vuln Reporting or encrypted email), response targets, scope, signing-key integrity + rotation pointer.
  • .github/workflows/lint.ymlreusable (workflow_call): shellcheck + yamllint (tolerant config tuned for Actions YAML: line-length/indentation/comments off, truthy: {check-keys: false} for the on: key) + a conditional astro check/build job that only fires when an astro.config.* is present.
  • profile/README.mdStatus section updated from 'specification only' to Phase 1 in progress (reflects M1.1a/M1.2/M1.3 landing + the pending P0).
  • README.md — documents the org-level files + the lint opt-in snippet.

Opt-in pattern (other repos)

# .github/workflows/lint.yml
name: Lint
on: { push: { branches: [main] }, pull_request: {} }
jobs:
  lint:
    uses: ZurvanLinux/.github/.github/workflows/lint.yml@main

Verification

  • All YAML files parse.
  • Reusable workflow lint.yml self-consistent.
  • Self-lint run green (will add the caller + dispatch after merge to confirm shellcheck/yamllint pass on the org repo itself).
  • Follow-up: wire the caller into iso-builder, apt-repository, website.

- ISSUE_TEMPLATE/{bug_report,feature_request}.yml + config.yml
  (blank issues off; contact links to website/spec/security). Bilingual note.
- PULL_REQUEST_TEMPLATE.md: spec-alignment + hard-constraint checklist.
- CONTRIBUTING.md: repo map, conventions, branch model, lint opt-in pattern.
- CODE_OF_CONDUCT.md: Contributor Covenant 2.1 (conduct@zurvanlinux.org).
- SECURITY.md: private reporting (GH Private Vuln Reporting / encrypted email),
  signing-key integrity + rotation pointer.
- .github/workflows/lint.yml: reusable workflow_call running shellcheck +
  yamllint (tolerant Actions-tuned config) and an astro check/build job gated
  on the presence of astro.config.*.
- profile/README.md: Status updated from 'spec only' to Phase 1 in progress.
- README.md: documents the org-level files and the lint opt-in snippet.
@mshafiee
mshafiee merged commit f90d45a into main Jul 20, 2026
@mshafiee
mshafiee deleted the feat/org-templates-and-lint branch July 20, 2026 21:29
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.

1 participant