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

Please improve packaging documentation (context, testing)

Open
#107 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
38/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
docker, linux
Domain
documentation

Research direction

Start with the Creating Packages page linked in the issue and verify the package-building prerequisites and supported environments. Check how makepkg and makepkg-mingw are obtained, whether crossroad supports local testing on Linux or Docker, and document the confirmed setup and testing path for someone preparing a PKGBUILD.

Written by the indexing model from the issue text.

Description

The Creating Packages page is missing a few poins which would be worth documenting:

  • starting context: for those who have not packaged anything yet (e.g. how to obtain makepkg and makepkg-mingw, does it run under Windows, under Linux, or is it Arch-only?).
  • testing the package: can I test the packaging under Linux? Is there a docker image ready for that?

I am running the crossroad cross-build environment and would like to test a new PKGBUILD (before creating the PR for it) locally, running Ubuntu (or Docker or anything else).

Dominant language
CSS
Stars
3.3k
Forks
446
PR merge metrics
No merged PRs in 30d

Getting set up

We have not checked this project's setup files yet. Start from its README, and see our first-contribution guide for the general steps.

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 msys2/msys2.github.io

All issues in msys2/msys2.github.io

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.