Skip to content

Latest commit

 

History

History
36 lines (20 loc) · 2.29 KB

CONTRIBUTING.md

File metadata and controls

36 lines (20 loc) · 2.29 KB

Contributing to Halfmoon

Please read this short document if you want to contribute to Halfmoon.

Our goal

Before getting to the issues and pull requests, it is important to understand what the framework is trying to do.

Halfmoon's stated goal is really simple - create a customizable frontend framework, with a built-in dark mode, that is great for building dashboards and tools. However, our other goals are more implicit:

  • Everything has to be super functional and snappy. Ideally, that means no performance issues and just consistently good execution.
  • Everything has to look good as well, and have a single, consistent style.

The most important thing here is building a really good (looking) framework that also works very well, and that should always be the top priority.

Issues

Please keep the following things in mind when raising issues:

  • Feature requests are welcome. However, please make sure that the feature you are requesting falls under the scope of the project.
  • Do not post personal support questions as issues. For those, use this tag on Stack Overflow.
  • When raising an issue, please be as thorough as possible. For possible bugs, reproducible code is always a great sign.

Pull requests

Please ask first before you put in work for a pull request. Things are constantly being worked on, and it is very difficult to share everything publicly in a meaningful way. So asking lets us avoid working on the same thing, or worse, someone putting in a lot of work for a PR that does not fit into the scope of the project. Please do not take this the wrong way; at this stage, the project needs strong leadership to become something special.

The best way to ask is through email: [email protected]. I am always open to proper discussions about the framework, especially when it comes to contributions and pull requests.

Documentation website

The repository for the documentation website is not public. Therefore, if you want to raise an issue regarding that, please send me an email: [email protected].

License

Any contribution you make will fall under the license being used by the framework: MIT license.