Merge pull request #2977 from port-labs/sivanel97-patch-1

Added header capitalization rules to the top of the best_practices

Author: sivanel97

best_practices.md

@@ -1,5 +1,19 @@
 # Port documentation style guide
 
+___
+
+**Header capitalization rules:** Use sentence case for headers with only the first word capitalized.
+
+❌ "## Sync Approaches And Methods"  
+✅ "## Sync approaches and methods"
+
+Note: Well-known product names such as Lambda, Kubernetes, ArgoCD, etc. should follow their standard capitalization rules and styling.
+
+❌ "aws"  
+✅ "AWS"
+
+___
+
 This document details guidelines for contributing to Port's documentation, and demonstrates how to correctly write and review documentation content.
 
 <b>Pattern 1: Always standardize collapsible details with bold titles and "(click to expand)" for consistency and usability across docs.</b>
@@ -208,18 +222,6 @@ Example code after:
 
 ___
 
-**Header capitalization rules:** Use sentence case for headers with only the first word capitalized.
-
-❌ "## Sync Approaches And Methods"  
-✅ "## Sync approaches and methods"
-
-Note: Well-known product names such as Lambda, Kubernetes, ArgoCD, etc. should follow their standard capitalization rules and styling.
-
-❌ "aws"  
-✅ "AWS"
-
-___
-
 <b>Pattern 9: Use "We" language instead of commanding "You" language to create a collaborative, guiding tone rather than issuing commands.</b>
 
 Example code before:
@@ -683,4 +685,4 @@ Before submitting your contribution, review it against this checklist:
 - [ ] Tone is consistent with Port's documentation style
 - [ ] Content is organized logically
 - [ ] Technical terms are explained or linked to definitions
-- [ ] No unnecessary jargon or marketing language
+- [ ] No unnecessary jargon or marketing language