A best practice is a guideline that developers should follow in your context. The topic can be various and you can address rules regarding a programming language, a framework, Architecture, Security, Performance, Clean code, or any topic you want.
You can define rules at any level, syntactic or more abstract, It's up to you.
A best practice has just a name that describes its intent and a description. It has also a list of examples. We use the concept of positive and negative examples when the source code follows or does not follow a best practice.
The documentation of your best practice comes from your users and your source code
When an example is added to a best practice, there's no link with the actual source code stored on Git, it's just a snapshot that will persist in Promyze.
Create best practice
There are 3 recommended ways to create your own best practices in Promyze: