Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Explain contributing.md

Open
#10 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Domain
documentation

Research direction

Start by locating the project-specific quirks in the current contributor guide and identify which repositories need their own CONTRIBUTING.md files. Review the linked elementary/icons CONTRIBUTING.md as prior art, then update the relevant repository guides and add the proposed intro section explaining where to look. Done means the duplicated quirks are moved and the contributor-docs introduction points readers to repository-level CONTRIBUTING.md files.

Written by the indexing model from the issue text.

Description

Needs Copy
Problem

Currently we have some project specific quirks in the contributor guide, but this is sometimes duplicate information and better kept in CONTRIBUTING.md files in each project to stay current. GitHub also surfaces contributing information when it's present, so there's some incentive to have it there in the repo

Proposal

We should move the current quirk info into CONTRIBUTING files on the relevant repos and instead add a section to the intro about looking for CONTRIBUTING.md files on the project repo

Prior Art (Optional)

https://github.com/elementary/icons/blob/master/CONTRIBUTING.md

Dominant language
No language data
Stars
5
Forks
4
Avg merge
23h 9m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from elementary/contributor-docs

All issues in elementary/contributor-docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.