Hey there, fellow open-source enthusiast! We are so happy that you're here and are showing interest in our open-source projects!
We really appreciate that you want to be part of our community and also want to help contribute to these projects, but just before you jump into work, please take some time and read through our simple guidelines. Don't worry, more specific information is always in the given repository's Readme file.
Branches, tags, and releases
The most important branch of the repository will be the default one on GitHub, i.e. the one selected by default when you open its GitHub page. Ongoing development is almost always done in the
dev branch. So if you want to get the latest but still usable source then checkout that one, or if you want to contribute please branch off from it. For Orchard extensions when it has an Orchard Core and Orchard 1.x version too then commonly the Orchard Core one is in the
dev branch and the Orchard 1.x one in the
Most of our projects won't have formal releases and versions, so just grab the latest
dev branch and get to work right away. For larger projects we do have releases (like for the Hastlayer SDK which you might want to check out to see some magic): In this case, we add a tag with the version number to the latest commit of that release and merge from the
dev branch to a release branch, usually
Running the projects locally
If you want to contribute to our Orchard Core extensions then please do so from the Open-Source Orchard Core Extensions solution since that's the simplest way of doing it. Otherwise, you'll find a solution file in the repository; just open it and you should be good to go with F5.
Please follow the software development guidelines elaborated in the Orchard Dojo Library. Otherwise, you'll find that apart from a few points, we follow the most widely used best practices and coding styles of the respective language/technology. Also, if you just look at the rest of the code in a given project you'll mostly see how we write programs so just try to write code in a similar manner if you contribute. In most of our projects, coding guidelines will be automatically enforced by analyzers as well. That's all.
Support and security issues
Unless otherwise specified the project's support channel is the issue tracker on GitHub, so please open issues there if needed. If you're looking for commercial-grade support then that's also available. Feel free to get in touch with us and tell us where you're stuck, what problems you're facing, or what questions need to be answered - we're happy to help!
If you have found a security issue with one of our projects please get in touch with us directly via security at lombiq.com before disclosing it publicly and we'll look into it ASAP. E-mails sent to this address are received by at least two engineers of ours.
Code of conduct
Please follow Wheaton's Law.