Thanks to visit codestin.com
Credit goes to github.com

Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

MCLOUD-6977: Update documentation about routes #7912

Merged
merged 22 commits into from
Sep 23, 2020

Conversation

NadiyaS
Copy link
Contributor

@NadiyaS NadiyaS commented Sep 22, 2020

Purpose of this pull request

Fixes #7444 .
Updates the Configure routes topic to clarify configuration for HTTP and HTTPS requests and improve examples.

Affected DevDocs pages

@devops-devdocs
Copy link
Collaborator

An admin must run tests on this PR before it can be merged.

@meker12 meker12 self-requested a review September 22, 2020 18:44
@meker12 meker12 added Internal Dev Differentiates work between community and Magento staff 2.x Technical Updates to the code or processes that alter the technical content of the doc labels Sep 22, 2020
{:.no-copy}

- If the configuration specifies only the HTTPS route, then all HTTP requests redirect to HTTPS.
For example, for the default domain `example.com`, the route `https://{default}/` resolves to URL `https://example.com/` and redirect `http://example.com/` to `https://example.com/`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For example, for the default domain `example.com`, the route `https://{default}/` resolves to URL `https://example.com/` and redirect `http://example.com/` to `https://example.com/`.
For example, for the default domain `example.com`, the route `https://{default}/` resolves to URL `https://example.com/` and redirects `http://example.com/` to `https://example.com/`.

Copy link
Contributor

@BarnyShergold BarnyShergold left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As this is complex I decided to read the majority in the file to get a proper view. Most looks ok but there is a passage that wasn't changed but indicates something different from reality.

{{site.data.var.ee}} also generates routes for every active Integration environment. For Integration environments, {default} is replaced with the following domain name:

[branch]-[project-id].[region].magentosite.cloud
{:.no-copy}

For example, the refactorcss branch for the mswy7hzcuhcjw project hosted in the us cluster has the following the domains:

http://www-refactorcss-mswy7hzcuhcjw.us.magentosite.cloud/

https://refactorcss-mswy7hzcuhcjw.us.magentosite.cloud/blog

Two projects checked show that the Integration domain seems to actually be formed thus :
[branch]-[random string]-[project-id].[region].magentosite.cloud

EG on our sandbox account -
https://barnyshergold-ym3j7iq-z3ek236yy2yv2.eu-4.magentosite.cloud/
https://pwastudio-7mqr7yq-z3ek236yy2yv2.eu-4.magentosite.cloud/
https://integration-5ojmyuq-z3ek236yy2yv2.eu-4.magentosite.cloud/

Other checked projects reflect the same - the second section has no pattern but exists. Can an explanation be included in the documentation?

@@ -120,11 +145,11 @@ The following sample route does not redirect from the `www` to the apex domain;
```yaml
"http://{default}/":
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add Example 2: line to label the second example.

Change explanatory text to

"In the following example, the route configuration does not redirect URLs from the www domain to the apex domain. Instead, requests are served from both the www and apex domain."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done


- If the configuration specifies only the HTTPS route, then all HTTP requests redirect to HTTPS. For example, for the default domain `example.com`, the route `https://{default}/` resolves to URL `https://example.com/` and redirects `http://example.com/` to `https://example.com/`.

What is similar to
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed, the phrase "What is similar to" and example can be deleted as the preceding bullet point explains the concept.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

NadiyaS and others added 3 commits September 23, 2020 10:12
@NadiyaS
Copy link
Contributor Author

NadiyaS commented Sep 23, 2020

Hi @BarnyShergold ,
Thanks for that notice.
I changed the pattern.

@meker12 meker12 self-requested a review September 23, 2020 16:51
Copy link
Contributor

@BarnyShergold BarnyShergold left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All good for me - just @meker12 's change needed

@meker12 meker12 changed the base branch from master to integrate-routes-pr September 23, 2020 17:16
@meker12 meker12 merged commit e4b7b9d into magento:integrate-routes-pr Sep 23, 2020
@ghost
Copy link

ghost commented Sep 23, 2020

Hi @NadiyaS, thank you for your contribution!
Please, complete Contribution Survey, it will take less than a minute.
Your feedback will help us to improve contribution process.

meker12 added a commit that referenced this pull request Sep 24, 2020
* MCLOUD-6977: Update documentation about routes

* Update src/cloud/project/routes.md

Co-authored-by: Margaret Eker <[email protected]>
Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Nadiya Syvokonenko <[email protected]>
meker12 added a commit that referenced this pull request Sep 29, 2020
* Update prereq-overview.md

* Update prereq-overview.md

Reword following review

* Update prereq-overview.md

Clarify MySQL version for 2.4

* Update prereq-overview.md

Version fix

* Update src/guides/v2.3/install-gde/prereq/prereq-overview.md

Suggested change

Co-authored-by: Barny Shergold <[email protected]>

* Update src/guides/v2.4/install-gde/prereq/prereq-overview.md

Suggested change

Co-authored-by: Barny Shergold <[email protected]>

* Update contributing.md

* Static fixes

* Fixed MD formatting

* Update ui-columnscontrols.md

<setting> is Invalid XML tag, correct tag is <settings>

* Fix return for extractAdjustment

* Update src/guides/v2.3/extension-dev-guide/price-adjustments.md

Co-authored-by: Yaroslav Rogoza <[email protected]>

* Capitalize MySQL

* Capitalize MySQL

* Added Sequence Load information

* Update message-queues-stores.md

Remote Warning for required patch

* Fix missing "\" in new implementation example

* Fix broken link (#7915)

* formatting change

* Editorial/elastic variable (#7919)

* Update Additional search configuration section

* Grammar update

* Update src/cloud/project/services-elastic.md

Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Donald Booth <[email protected]>
Co-authored-by: Margaret Eker <[email protected]>

* Grammar and formatting

* I linted myself.

* typo

* Usage examples are added

* Markdown fixes

* MCLOUD-6977: Update documentation about routes (#7912) (#7927)

* MCLOUD-6977: Update documentation about routes

* Update src/cloud/project/routes.md

Co-authored-by: Margaret Eker <[email protected]>
Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Nadiya Syvokonenko <[email protected]>

* [WIP] Added Slave Database Connection Information (#7924)

* Added Slave Database Connection Information
* Update src/cloud/project/services-mysql.md

* Update services-mysql.md

Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Margaret Eker <[email protected]>

* (maintenance) Add init to build:stage (#7941)

* Add init to build:stage

Required for new CI/CD staging

* Fix syntax

* Improving the create a new page layout topic

* Update project-routes-more-redir.md

Removed extra curly brace

* Grammar and formatting

* Update GraphQL index page

Co-authored-by: DominicWatts <[email protected]>
Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Stanislav Idolov <[email protected]>
Co-authored-by: Jeff Matthews <[email protected]>
Co-authored-by: Keyur Shah <[email protected]>
Co-authored-by: Iftakharul Alam <[email protected]>
Co-authored-by: Yaroslav Rogoza <[email protected]>
Co-authored-by: Donald Booth <[email protected]>
Co-authored-by: Barny Shergold <[email protected]>
Co-authored-by: Lyzun Oleksandr <[email protected]>
Co-authored-by: Brett P <[email protected]>
Co-authored-by: Margaret Eker <[email protected]>
Co-authored-by: hguthrie <[email protected]>
Co-authored-by: Kevin Harper <[email protected]>
Co-authored-by: Nadiya Syvokonenko <[email protected]>
Co-authored-by: Dmitry Shevtsov <[email protected]>
Co-authored-by: eduard13 <[email protected]>
Co-authored-by: Kevin Harper <[email protected]>
meker12 added a commit that referenced this pull request Oct 2, 2020
* MCLOUD-6977: Update documentation about routes (#7912)

* Update src/cloud/project/routes.md

* Update project-routes-more-redir.md

Removed extra curly brace

* Update src/cloud/project/routes.md

  -  Moved description for Example 1 in Simple routes section to correct location

* Additional cleanup and corrections

- Cleaned up formatting and presentation of examples to improve readability
- Corrected the command and example for routing a non-mapped domain


Co-authored-by: hguthrie <[email protected]>
Co-authored-by: Nadiya Syvokonenko <[email protected]>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
2.x Internal Dev Differentiates work between community and Magento staff Technical Updates to the code or processes that alter the technical content of the doc
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOCS] The routes.yaml docs are either wrong or very confusing
4 participants