Code guidelines

Guidelines for code best practices.

a cover alternative title

Windows Content Link to this heading

This tab is for Windows users.

Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa protulit, sed sed aere valvis inhaesuro Pallas animam: qui quid, ignes. Miseratus fonte Ditis conubia.

MacOS Content Link to this heading

This tab is for *MacOS users.

Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa protulit, sed sed aere valvis inhaesuro Pallas animam: qui quid, ignes. Miseratus fonte Ditis conubia.

Linux Content Link to this heading

This tab is for *Linux users.

Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa protulit, sed sed aere valvis inhaesuro Pallas animam: qui quid, ignes. Miseratus fonte Ditis conubia.

Although this chapter is not FreeCAD specific, it is provided here to help both developers and code reviewers to ensure clean and easily maintainable code. The practices presented should be treated like food recipes - you can play with them, alter them - but every change should be thoughtful and intentional.

While this guideline might not be consistently followed throughout all of the existing codebase, adhering to these practices moving forward will help improve the overall quality of the code and make future contributions more maintainable. Consider it as inspiration for the better future.

For Developers Link to this heading

If you are a developer and want to read what we consider as good code please consult practices mentioned below. These guidelines try to define what the good code is and how it should be written.

For Reviewers Link to this heading

For reviews it is good to have a set of concrete rules that are easy to follow. If you want to learn how to review code, or simply want to learn how we check code please consult the reviewer guide .