Skip to content

Commit 711e3a4

Browse files
committed
Review
1 parent 571474d commit 711e3a4

3 files changed

Lines changed: 6 additions & 6 deletions

File tree

content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/microflows/microflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ URLs are not supported for microflows that have non-persistable entities or list
5353
{{%/alert %}}
5454

5555
{{% alert color="info" %}}
56-
Page and microflow URL patterns must be unambiguous. If two patterns could match the same URL, the runtime has no way to resolve which one to open. For recommendations on structuring URLs and resolving conflicts, see [Page and Microflow URLs](/refguide/general-best-practices/#page-and-microflow-urls).
56+
Page and microflow URL patterns must be unambiguous. If two patterns match the same URL, the Mendix Runtime cannot determine which page or microflow to open. For best practices on structuring URLs and resolving conflicts, see the [Page and Microflow URLs](/refguide/general-best-practices/#page-and-microflow-urls) section in *General Development Best Practices*.
5757
{{% /alert %}}
5858

5959
### Common Section {#common}

content/en/docs/refguide/modeling/best-practices/dev-best-practices/general-guidelines.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -41,15 +41,15 @@ When designing page and microflow URLs, prefer clear path segments over compact
4141
* Use `-` to separate words within a static segment, for example, `orders/request-return-label`
4242
* Use a strong unique prefix to ensure uniqueness of the URL
4343

44-
This makes URLs easier to read, easier to maintain, and less likely to conflict with other URLs.
44+
Following these best practices makes URLs easier to read and maintain, and helps prevent conflict with other URLs.
4545

4646
URL conflicts are checked per path segment. Two URLs are considered conflicting when they have the same number of segments and Studio Pro cannot tell, from the URL structure alone, which page or microflow should handle the request. A conflict can be full or partial.
4747

48-
A full conflict means the patterns overlap for all matching values. In other words, every URL that matches one pattern also matches the other. For example, `product/{Product/Name}` and `product/{Product/Code}` always conflict because both patterns accept any value in the second segment, so Studio Pro cannot use the URL itself to tell them apart. This means there is no single possible URL that will not be conflicting. For example, `https://example.com/p/product/chair` matches both patterns.
48+
A full conflict means that the patterns overlap for all matching values. In other words, every URL that matches one pattern also matches the other. For example, `product/{Product/Name}` and `product/{Product/Code}` always conflict because both patterns accept any value in the second segment. Therefore, Studio Pro cannot use the URL itself to tell them apart. This means that there is no URL that does not conflict. For example, `https://example.com/p/product/chair` matches both patterns.
4949

50-
A partial conflict means the patterns overlap only for specific values. Most URLs are still unique, but some URLs can match both patterns. For example, `product-{Name}` and `product-overview` only conflict for the URL `product-overview`, because `Name` can be `overview`. In that case, Studio Pro cannot tell whether `overview` is meant to be a fixed URL or a parameter value. For example, `https://example.com/p/product-overview` matches both patterns, while `https://example.com/p/product-chair` only matches `product-{Name}`.
50+
A partial conflict means that the patterns overlap only for specific values. Most URLs remain unique, but some can match both patterns. For example, `product-{Name}` and `product-overview` only conflict for the URL `product-overview`, because `Name` can be `overview`. In that case, Studio Pro cannot tell whether `overview` is meant to be a fixed URL or a parameter value. For example, `https://example.com/p/product-overview` matches both patterns, whereas `https://example.com/p/product-chair` only matches `product-{Name}`.
5151

52-
When a request matches conflicting URL patterns, the runtime picks one pattern and tries to open it. Which pattern is chosen is undefined. This can lead to unexpected behavior or a not-found page. For example, `https://example.com/p/product-overview` matches both `product-{Name}` and `product-overview`. If the selected pattern does not resolve to valid values, the request can fail even though the other pattern would have worked.
52+
When a request matches conflicting URL patterns, the Mendix Runtime selects one of them to open. Which pattern is selected is undefined. This can lead to unexpected behavior or a not-found page. For example, `https://example.com/p/product-overview` matches both `product-{Name}` and `product-overview`. If the selected pattern does not resolve to valid values, the request can fail even though the other pattern would have worked.
5353

5454
Common full conflict cases include the following:
5555

content/en/docs/refguide/modeling/pages/page/page-properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Mendix does not recommend configuring page URLs for pages that are displayed as
107107
{{%/alert %}}
108108

109109
{{% alert color="info" %}}
110-
Page and microflow URL patterns must be unambiguous. If two patterns could match the same URL, the runtime has no way to resolve which one to open. For recommendations on structuring URLs and resolving conflicts, see [Page and Microflow URLs](/refguide/general-best-practices/#page-and-microflow-urls).
110+
Page and microflow URL patterns must be unambiguous. If two patterns match the same URL, the Mendix Runtime cannot determine which page or microflow to open. For best practices on structuring URLs and resolving conflicts, see the [Page and Microflow URLs](/refguide/general-best-practices/#page-and-microflow-urls) section in *General Development Best Practices*.
111111
{{% /alert %}}
112112

113113
### Common Section {#common}

0 commit comments

Comments
 (0)