Guidelines to Lombiq's open-source projects

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.

Want to see all the stuff we've done? Check out all of our open-source projects listed on GitHub and see what else we're doing in open-source.

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 dev-orchard-1 branch.

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 master.

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.

Coding guidelines

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 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.