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 1.x and an Orchard Core version too then commonly the former is in the dev branch and the latter in the orchard-core 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.

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 projects you'll mostly see how we write programs so just try to write code in a similar manner if you contribute. If you want to contribute to our Orchard Core extensions then please do so from the Open-Source Orchard Core Extensions solution: That way most of the coding guidelines will be automatically enforced by analyzers. 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.