doc: Document commit message format
This commit is contained in:
		
							parent
							
								
									dcf89bcc8b
								
							
						
					
					
						commit
						ef69ceaf13
					
				
							
								
								
									
										29
									
								
								docs/COMMITS.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										29
									
								
								docs/COMMITS.md
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,29 @@
 | 
			
		||||
## About commit messages
 | 
			
		||||
 | 
			
		||||
Commit messages should follow the [conventional commit specification](https://www.conventionalcommits.org/en/v1.0.0/)
 | 
			
		||||
 
 | 
			
		||||
The format is: 
 | 
			
		||||
```
 | 
			
		||||
<type>[(optional scope)]: <description>
 | 
			
		||||
 | 
			
		||||
[optional body]
 | 
			
		||||
 | 
			
		||||
[optional footer(s)]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The type is one of:
 | 
			
		||||
- **fix**: Commit fixes a bug
 | 
			
		||||
- **feat**: Commit introduces a new feature
 | 
			
		||||
- **refactor**: Commit refactors code
 | 
			
		||||
- **perf**: Commit optimizes performance
 | 
			
		||||
- **doc**: Commit changes or adds documentation
 | 
			
		||||
 | 
			
		||||
A scope may be appended to the type, for example:
 | 
			
		||||
`feat(renderer): Implement the good lights`
 | 
			
		||||
 | 
			
		||||
If a commit introduces a breaking API change, a exclamation point (!) is added after the type:
 | 
			
		||||
`feat(renderer)!: New render view api`
 | 
			
		||||
 | 
			
		||||
Optionally, a breaking change may contain a "BREAKING CHANGE: <description>" footer,
 | 
			
		||||
that explains the change.
 | 
			
		||||
 | 
			
		||||
		Loading…
	
		Reference in New Issue
	
	Block a user