Contributing
Overview
Lunar is an open source project, and so by its very nature, welcomes contributions.
You can contribute to the project in many different ways. Reporting bugs, fixing bugs, helping with the documentation, making suggestions and submitting improvements to the software.
Monorepo
Lunar uses a monorepo lunarphp/lunar approach to maintaining its codebase. Monorepos are quite common, but may not be familiar to some. The monorepo helps us to organise the code for ease of development.
Contributing Code
The basic process for contributing to Lunar is as follows...
- Fork the monorepo
- Clone your fork locally
- Make your changes
- Ensure the tests run and complete successfully
- Submit a pull request
However, if you're not used to working with monorepo's and setting them up inside a test Laravel application, no problem!
TIP
Here's a guide on how to set-up your development environment ready for contributing to Lunar. Setting Up Lunar For Local Development
Found a Bug?
If you find a bug in the software please raise a GitHub Issue on the lunarphp/lunar repository. Please ensure that your issue includes the following:
Minimum
- Clear title and description of the issue
- Steps on how to reproduce the issue
Ideal
- An accompanying Pull Request with a test to demonstrate the issue.
Lunar is an open source project and as such we want contribution to be as accessible as possible and to enable contributors to actively collaborate on features and issues. By making sure you provide as much information as possible you are giving your issue the best chance to get the attention it needs.
Be aware that creating an issue does not mean it will get activity straight away, please be patient and understand we will do our best to look into it as soon as possible.
Open source code belongs to all of us, and it's all of our responsibility to push it forward.
Proposing a Feature
Before you start coding away on the next awesome feature, we highly recommend starting a discussion to check that your contribution will be welcomed. We would hate for you to spend valuable time on something that won't be merged into Lunar.
However, you're more than welcome to code away on your idea if you think it will help the discussion.
Making a Pull Request
When making a pull request, there should be a suitable template for you to follow to ensure the bug or feature can be reviewed in a timely manner. If the pull request is missing information or unclear as to what it offers or solves, it could any delay movement or be closed.
A PR should be able to include the following:
- The title should be relevant and quickly explain what to expect inside
- A clear description of the feature or fix
- References to any issues the PR resolves
- Label as either a
bug
,enhancement
,feature
ordocumentation
- Any relevant documentation updates
- Unit tests with adequate code coverage
Code Styles
Lunar currently uses Laravel Pint for code styling. This is not automatically triggered, so you will need to run vendor/bin/pint
on your branch.
Asset compiling
The Lunar hub and some other add-ons/utils will provide their own assets. Please do not commit these files as they will be overwritten by the core team when the release is being finalised.
Documentation Updates
When providing updates to the documentation, your pull request should target the relevant branch for the version you are updating. For documentation of new features in an upcoming release, target the main
branch.
If you would like to contribute to the documentation you can do easily by following these instructions...
- Fork the monorepo
lunarphp/lunar
- Clone your fork locally
- In your terminal change to the
/docs
directory - Run
npm install
- Run
npm run docs:dev
to preview the documentation locally - Make your changes
- Submit a pull request
Lunar uses VitePress for our documentation site which uses Markdown files to store the content. You'll find these Markdown files in the /docs
directory.