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

AGENTS.md / README / CONTRIBUTING describe an older layout and toolchain

Open
#1,417 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

@fhammerschmidt is already working on this.

Since Oct 11, 2026.

  • #1449 by @fhammerschmidt — open

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript, markdown

Research direction

Start with the line references in AGENTS.md, README.md and CONTRIBUTING.md, checking each against the current tree: .vscode/extensions.json, .oxfmtrc.json, and the test-hrefs script for its glob and CI behaviour. Fix each stale claim (formatter, Yarn version, tracked generated files, paths, removed directories) and confirm yarn test runs the checks the docs list. Done when every item in the issue matches the repository, or the related docs are removed.

Written by the indexing model from the issue text.

Description

Prettier instead of oxfmt (README:97, AGENTS:42,200, .vscode/extensions.json), Yarn 4.12 vs 4.13 (AGENTS:10, .oxfmtrc.json:41), generated .jsx/.mjs said to be tracked (AGENTS:203), paths relative to apps/docs presented as root paths, plugins/, MdxRoute.res, react-router-mdx, tailwind.config.js (CONTRIBUTING:75), compilers/ described as used, "fully pre-rendered" vs SSR /try, yarn test runs three checks not two, test-hrefs ignores its documented glob argument and only fails under CI.


Line numbers refer to master at ff3eac6e.

Dominant language
MDX
Stars
1.9k
Forks
261
Avg merge
1d 16h
Merged PRs (30d)
32

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 rescript-lang/rescript-lang.org

All issues in rescript-lang/rescript-lang.org

Similar issues

More DevTools issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.