# Contributing

<!-- Copy of ./src/content/docs/about/contributing.mdx -->

Contributions are greatly appreciated.

1. :star: Show your support by
   [starring the project on GitHub][linkProjectStargazers]!
1. :heart: Spread the word and help others discover this project.
1. :thought_balloon: Share your thoughts, ideas, or issues on
   [GitHub][linkProjectIssue] to help the project grow.
1. :computer: Contribute improvements, fixes, or new features following the
   [GitHub pull request][linkGitHubPR] model. Note: Before starting any work,
   please either comment on an existing [issue][linkProjectIssue] or file a new
   one.
   1. Read [3 Musketeers website development][linkProjectREADME]
   1. [Fork][linkGitHubFork] this [repository][linkProjectRepo]
   1. Clone the forked repository
   1. _Optionally_, create a new branch with a meaningful name
   1. Make your changes
   1. Execute `make ciTest`
   1. Commit and push your changes
   1. Create a [pull request from a fork][linkGitHubPRFork]

[linkProjectStargazers]: https://github.com/flemay/3musketeers/stargazers
[linkGitHubFork]: https://help.github.com/en/github/getting-started-with-github/fork-a-repo
[linkGitHubPRFork]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork
[linkGitHubPR]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests
[linkProjectIssue]: https://github.com/flemay/3musketeers/issues
[linkProjectREADME]: https://github.com/flemay/3musketeers?tab=readme-ov-file#3-musketeers-website-development
[linkProjectRepo]: https://github.com/flemay/3musketeers