Merge pull request mendix#10747 from mendix/ctl-doc-shortening

ConnorLand · web-flow · commit 1bc20ea23c63 · 2026-02-18T15:11:09.000+01:00
Too long to translate: Best Development Practices
diff --git a/content/en/docs/marketplace/create-content/create-solutions/sol-adapt/sol-architecting.md b/content/en/docs/marketplace/create-content/create-solutions/sol-adapt/sol-architecting.md
@@ -146,7 +146,7 @@ For example, a solution contains a module like the [Excel Importer](/appstore/mo
 
 ### Clean Coding
 
-Mendix recommends adhering to the [Mendix Best Practices for Development](/refguide/dev-best-practices/) and having clear coding conventions. 
+Mendix recommends adhering to [development best practices](/refguide/dev-best-practices/) and having clear coding conventions. 
 
 {{% alert color="warning" %}}
 This is even more important for solutions that will be adapted at the model level.
diff --git a/content/en/docs/marketplace/create-content/guidelines-content-creators.md b/content/en/docs/marketplace/create-content/guidelines-content-creators.md
@@ -345,5 +345,5 @@ For more information on what this program offers, see [Mendix Component Partner
 ## Read More
 
 * [Community Best Practices for App Performance](/refguide/community-best-practices-for-app-performance/)
-* [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* [Development Best Practices](/refguide/dev-best-practices/)
 * [Best Practices for Creating Connectors](/appstore/creating-content/connector-guide-best-practices/)
diff --git a/content/en/docs/quickstarts/native-mobile-app.md b/content/en/docs/quickstarts/native-mobile-app.md
@@ -163,7 +163,7 @@ Looking to get in touch with us or the community? Join our [Slack community work
 ## Read More
 
 * [Studio Pro Overview](/refguide/studio-pro-overview/) – describes Studio Pro tabs, menus, and shortcut keys
-* [Mendix Best Practices for Development](/refguide/dev-best-practices/) – a reference for adopting consistent naming and modeling conventions while developing your Mendix apps
+* [Development Best Practices](/refguide/dev-best-practices/) – a reference for adopting consistent naming and modeling conventions while developing your Mendix apps
 * [Starting with App from a Spreadsheet](/refguide/app-from-spreadsheet/) – describes importing a Microsoft Excel spreadsheet and building an app using your data
 * [Mendix Academy Become a Rapid Developer](https://academy.mendix.com/link/paths/31/Become-a-Rapid-Developer) – the learning path recommended for new Mendix users who want to create their first app using low-code
 * [Mendix Academy Crash Course](https://academy.mendix.com/link/paths/82/Crash-Course) – the learning path recommended for new Mendix users who are also experienced developers
diff --git a/content/en/docs/quickstarts/responsive-web-app.md b/content/en/docs/quickstarts/responsive-web-app.md
@@ -263,7 +263,7 @@ Looking to get in touch with us or the community? Join our [Slack community work
 ## Read More
 
 * [Studio Pro Overview](/refguide/studio-pro-overview/) – describes Studio Pro tabs, menus, and shortcut keys
-* [Mendix Best Practices for Development](/refguide/dev-best-practices/) – a reference for adopting consistent naming and modeling conventions while developing your Mendix apps
+* [Development Best Practices](/refguide/dev-best-practices/) – a reference for adopting consistent naming and modeling conventions while developing your Mendix apps
 * [Starting with App from a Spreadsheet](/refguide/app-from-spreadsheet/) – describes importing a Microsoft Excel spreadsheet and building an app using your data
 * [Mendix Academy Become a Rapid Developer](https://academy.mendix.com/link/paths/31/Become-a-Rapid-Developer) – the learning path recommended for new Mendix users who want to create their first app using low-code
 * [Mendix Academy Crash Course](https://academy.mendix.com/link/paths/82/Crash-Course) – the learning path recommended for new Mendix users who are also experienced developers
diff --git a/content/en/docs/refguide/installation/performance-tips/_index.md b/content/en/docs/refguide/installation/performance-tips/_index.md
@@ -52,4 +52,4 @@ Antivirus software can sometimes impact the performance of Studio Pro. To mitiga
 ## Read More
 
 * [Community Best Practices for App Performance](/refguide/community-best-practices-for-app-performance/)
-* [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/_index.md b/content/en/docs/refguide/mobile/best-practices/_index.md
@@ -19,4 +19,4 @@ Guides in this section will help you apply best practices and patterns when buil
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/batch-synchronization.md b/content/en/docs/refguide/mobile/best-practices/batch-synchronization.md
@@ -63,4 +63,4 @@ To improve your apps further, consult the following recommendations:
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/compound-object.md b/content/en/docs/refguide/mobile/best-practices/compound-object.md
@@ -60,4 +60,4 @@ To improve your apps further, consult the following recommendations:
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/deleted-flag.md b/content/en/docs/refguide/mobile/best-practices/deleted-flag.md
@@ -36,4 +36,4 @@ To improve your apps further, consult the following recommendations:
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/incremental-synchronization.md b/content/en/docs/refguide/mobile/best-practices/incremental-synchronization.md
@@ -63,4 +63,4 @@ To improve your apps further, consult the following recommendations:
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/mobile/best-practices/request-object.md b/content/en/docs/refguide/mobile/best-practices/request-object.md
@@ -46,4 +46,4 @@ To improve your apps further, consult the following recommendations:
 
 ## Read More
 
-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)
+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)
diff --git a/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/microflows/_index.md b/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/microflows/_index.md
@@ -14,7 +14,7 @@ Microflows run in the runtime server and can therefore not be used in offline ap
 
 This page is a summary of the elements which make up a microflow, together with their visual representation within the microflow. It also covers [keyboard support](#keyboard) when editing microflows.
 
-For the properties of the microflow itself, see [Microflow Properties](/refguide/microflow/). For microflow best practices, see [Microflow Naming Conventions](/refguide/dev-best-practices/#microflow-naming-conventions), [Microflow General Best Practices](/refguide/dev-best-practices/#microflow-dev-best-practices), and [Microflow Best Practices from the Community](/refguide/community-best-practices-for-app-performance/#microflow-community-best-practices).
+For the properties of the microflow itself, see [Microflow Properties](/refguide/microflow/). For microflow best practices, see the[Microflows](/refguide/naming-convention-best-practices/#microflow-naming-conventions/) section of *Naming Convention Best Practices*, [Microflow General Best Practices](/refguide/general-best-practices/#microflow-dev-best-practices), and [Microflow Best Practices from the Community](/refguide/community-best-practices-for-app-performance/#microflow-community-best-practices).
 
 For information on using microflows as data sources, see [Microflow Source](/refguide/microflow-source/).
 
diff --git a/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/microflows/extract-and-use-sub-microflows.md b/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/microflows/extract-and-use-sub-microflows.md
@@ -45,7 +45,7 @@ To extract the validation steps into a sub-microflow, follow these steps:
 
 3. In the **Add microflow** dialog box, enter a name for the sub-microflow.
 
-    {{% alert color="info" %}}As a best practice, use a consistent naming scheme that clearly identifies the sub-microflow, for example, *SUB_{Microflow description}*. For more naming best practices, see [Microflow Naming Conventions](/refguide/dev-best-practices/#microflow-naming-conventions).{{% /alert %}}
+    {{% alert color="info" %}}As a best practice, use a consistent naming scheme that clearly identifies the sub-microflow, for example, *SUB_{Microflow description}*. For more naming best practices, see the [Microflow](/refguide/naming-convention-best-practices/#microflow-naming-conventions/) section of *Naming Convention Best Practices*.{{% /alert %}}
 
 4. Click **OK**.
 5. Open the sub-microflow by right-clicking the sub-microflow call and selecting **Go to microflow**.
diff --git a/content/en/docs/refguide/modeling/best-practices/dev-best-practices.md b/content/en/docs/refguide/modeling/best-practices/dev-best-practices.md
diff --git a/content/en/docs/refguide/modeling/best-practices/dev-best-practices/_index.md b/content/en/docs/refguide/modeling/best-practices/dev-best-practices/_index.md
diff --git a/content/en/docs/refguide/modeling/best-practices/dev-best-practices/app-setup.md b/content/en/docs/refguide/modeling/best-practices/dev-best-practices/app-setup.md
diff --git a/content/en/docs/refguide/modeling/best-practices/dev-best-practices/general-guidelines.md b/content/en/docs/refguide/modeling/best-practices/dev-best-practices/general-guidelines.md
diff --git a/content/en/docs/refguide/modeling/best-practices/dev-best-practices/naming-conventions.md b/content/en/docs/refguide/modeling/best-practices/dev-best-practices/naming-conventions.md
diff --git a/content/en/docs/refguide/version-control/version-control-troubleshooting/repository-size.md b/content/en/docs/refguide/version-control/version-control-troubleshooting/repository-size.md

Original file line number	Diff line number	Diff line change
`@@ -19,4 +19,4 @@ Guides in this section will help you apply best practices and patterns when buil`
`19`	`19`
`20`	`20`	`## Read More`
`21`	`21`
`22`		`-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)`
	`22`	`+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)`
Original file line number	Diff line number	Diff line change
`@@ -63,4 +63,4 @@ To improve your apps further, consult the following recommendations:`
`63`	`63`
`64`	`64`	`## Read More`
`65`	`65`
`66`		`-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)`
	`66`	`+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)`
Original file line number	Diff line number	Diff line change
`@@ -60,4 +60,4 @@ To improve your apps further, consult the following recommendations:`
`60`	`60`
`61`	`61`	`## Read More`
`62`	`62`
`63`		`-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)`
	`63`	`+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)`
Original file line number	Diff line number	Diff line change
`@@ -36,4 +36,4 @@ To improve your apps further, consult the following recommendations:`
`36`	`36`
`37`	`37`	`## Read More`
`38`	`38`
`39`		`-* To increase the clarity, organization, and documentation of your apps, see [Mendix Best Practices for Development](/refguide/dev-best-practices/)`
	`39`	`+* To increase the clarity, organization, and documentation of your apps, see [Development Best Practices](/refguide/dev-best-practices/)`