Skip to content

Data entity document improvement #693

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

ajithkumar-maragathavel
Copy link
Contributor

Description

Improved the Data entity MFTF document by providing examples for each data entity node.
Added example from the already defined MFTF test for each sub-topic.

Affected Pages

Contribution checklist

  • Pull request has a meaningful description of its purpose
  • All commits are accompanied by meaningful commit messages
  • All new or changed code is covered with unit/verification tests (if applicable)
  • All automated tests passed successfully (all builds on Travis CI are green)
  • Changes to Framework doesn't have backward incompatible changes for tests or have related Pull Request with fixes to tests

@magento-engcom-team magento-engcom-team added Partner: Ziffity partners-contribution Pull Request is created by Magento Partner labels Apr 29, 2020
@coveralls
Copy link

coveralls commented Apr 29, 2020

Coverage Status

Coverage increased (+2.2%) to 55.944% when pulling 657aabb on ajithkumar-maragathavel:data-entity-improvements into 254551d on magento:develop.

docs/data.md Outdated
@@ -32,6 +48,12 @@ In this example:
* `MAGENTO_ADMIN_USERNAME` is a name of an environment variable.
The corresponding value will be assigned to `userInput` as a result.

The following is the usage of `_ENV` in the `Magento/Braintree/Test/Mftf/ActionGroup/AdminDeleteRoleActionGroup.xml` action group:
Copy link
Contributor

Choose a reason for hiding this comment

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

"The following is an example of the usage of..."
Same with L72 and L96.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dobooth Updated the changes.

docs/data.md Outdated
@@ -107,7 +145,7 @@ userInput="We'll email you an order confirmation with details and tracking info.

## Format

The format of `<data>` is:
The format of `<data>` entity is:
Copy link
Contributor

Choose a reason for hiding this comment

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

"The format of the data...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dobooth Updated the changes.

docs/data.md Outdated
@@ -205,7 +243,7 @@ You can also call data from the xml definition of a `data` tag directly:

Attributes|Type|Use|Description
---|---|---|---
`name`|string|optional|Name of the `<entity>`.
`name`|string|optional|Name of the `<entity>`. Camel case is used for the entity name.
Copy link
Contributor

Choose a reason for hiding this comment

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

"Use camel case for entity names."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dobooth Updated the changes. Please review it.

docs/data.md Outdated
@@ -231,6 +275,12 @@ Attributes|Type|Use|Description
`entityKey`|string|optional|Key attribute of the referenced entity from which to get a value.
`unique`|--|--|*This attribute hasn't been implemented yet.*

Example:

```
Copy link
Contributor

Choose a reason for hiding this comment

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

Use xml as the codeblock type.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dobooth This has been done. Please review it.

@dobooth dobooth added the DOC label Jun 26, 2020
@dobooth dobooth changed the base branch from develop to annual-docs July 24, 2020 14:00
@dobooth dobooth merged commit 0f64e29 into magento:annual-docs Jul 24, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
DOC Partner: Ziffity partners-contribution Pull Request is created by Magento Partner
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants