Skip to content

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

Open
alphacrack wants to merge 1 commit into
mainfrom
chore/oss-best-practices-single-branch
Open

chore: OSS best practices + single-branch model#56
alphacrack wants to merge 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
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