Skip to content

chore: OSS best practices + single-branch model - #56

Merged
alphacrack merged 1 commit into
mainfrom
chore/oss-best-practices-single-branch
Jul 27, 2026
Merged

chore: OSS best practices + single-branch model#56
alphacrack merged 1 commit into
mainfrom
chore/oss-best-practices-single-branch

Conversation

@alphacrack

Copy link
Copy Markdown
Owner

Summary

Applies open-source best-practice polish and aligns docs with the single-branch (trunk-based) model.

Best practices

  • README badges — CI status, PyPI version, supported Python versions, MIT license, Contributor Covenant. Also removes the stray duplicate # README.md H1 (the file had two H1s).
  • .editorconfig — consistent charset / line endings / indentation across editors (4-space Python, 2-space YAML/JSON/TOML).

Single-branch model

  • CONTRIBUTING — contributors now branch off main and PR to main (was development); notes the required ci-ok gate.
  • dependabot — dropped target-branch: development so update PRs follow the default branch.

Note: .github/workflows/ci.yml still lists [main, development] in its triggers on purpose — harmless, and avoids a CI gap during the branch rename. development becomes inert once renamed.

Companion action (owner-only, blocked for automation)

This PR is the file half of the single-branch switch. The structural half — renaming developmentmain — needs a maintainer (the permission classifier blocks it for the agent):

gh api -X POST repos/alphacrack/python-maithili-dsl/branches/development/rename -f new_name=main

GitHub auto-retargets open PRs and branch protections on rename. After that, delete the now-stale protect-development ruleset.

Test Evidence

Docs/config only — no source changes. YAML validated locally.

Security Considerations

N/A.

Breaking Changes

None.

🤖 Generated with Claude Code

- README: add CI / PyPI / Python-versions / License / CoC badges;
  drop the stray duplicate '# README.md' H1
- CONTRIBUTING: switch to single-branch (trunk) model — topic branch
  off main, PRs target main, note the required ci-ok gate
- dependabot: drop target-branch (follows the default branch now)
- add .editorconfig for consistent whitespace/encoding across editors

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@alphacrack alphacrack added documentation Improvements or additions to documentation infra CI/CD, tooling, automation P3 Low priority: nice to have labels Jul 23, 2026
@alphacrack
alphacrack merged commit 2c70bdd into main Jul 27, 2026
7 checks passed
@alphacrack
alphacrack deleted the chore/oss-best-practices-single-branch branch July 27, 2026 20:34
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 infra CI/CD, tooling, automation P3 Low priority: nice to have

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant