Skip to content

docs: merge HACKING.md into CONTRIBUTING.md, fewer files in root - #2734

Open
benhoyt wants to merge 7 commits into
canonical:mainfrom
benhoyt:reduce-files-in-root
Open

docs: merge HACKING.md into CONTRIBUTING.md, fewer files in root#2734
benhoyt wants to merge 7 commits into
canonical:mainfrom
benhoyt:reduce-files-in-root

Conversation

@benhoyt

@benhoyt benhoyt commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

This PR makes several changes to reduce the number of files in the root directory of the repo.

Most significantly, it moves the content of HACKING.md into CONTRIBUTING.md without changing any of it (except minor adjustments to the headings):

  • Setting up a dev environment: moved straight across
  • Testing: merged with "Tests"
  • Maintaining the documentation: merged with "Documentation"
  • Dependencies: moved to under "Pull requests"
  • Dev tools: merged with "Setting up a dev environment"
  • Releases: moved straight across
  • Updating the Charmcraft profiles: moved to a top-level section

Within CONTRIBUTING.md:

  • Moves "Coding style" up to a sub-section under "Pull requests"
  • Removes the "Reviews" section; I actually did this by accident, but I don't think it pays for itself and should be removed (it's obvious)

In addition, the PR:

  • Moves CODE_OF_CONDUCT.md into the .github dir (GitHub still shows a tab)
  • Moves sbomber config files into .github
  • Moves release.py into .github (I know we're going to replace it soon, but no harm in the meantime -- we run it with tox.ini anyway)
  • Removes STYLE.md, as its content is now at https://github.com/canonical/charm-tech/tree/main/style

The only change I'm not sure about is how I'm referencing the new style guides in AGENTS.md. Will agents pick those up?

NOTE: I plan a follow-up PR to clean up CONTRIBUTING.md a bit, as I think there's a bit of duplicate content there now, and probably some things that can be removed or shortened.

Fixes #2487

This commit moves content without changing any of it (except
appropriate adjustments of headings).

- Setting up a dev environment: moved straight across
- Testing: merged with "Tests"
- Maintaining the documentation: merged with "Documentation"
- Dependencies: moved to under "Pull requests"
- Dev tools: merged with "Setting up a dev environment"
- Releases: moved straight across
- Updating the Charmcraft profiles: moved to a top-level section

In addition, within the document:

- Moved "Coding style" up to a sub-section under "Pull requests"

I also added an extra blank line between top-level sections.
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.

Reduce number of files at repo root

1 participant