Master #23027
Master #23027
Conversation
There was a problem hiding this comment.
Xavier, this tutorial would benefit by using a more active voice throughout. You state many times "you will need" and you can make this more active by stating, "you need." It is okay to be more direct as you are essentially instructing a user to perform action-oriented steps. Also, please use numbered lists as sub-steps for each step. This helps the user work through the sequence.
| ) to setup your SAP Build and SAP Cloud ALM environments | ||
|
|
||
| ## Intro | ||
| In the end of this blog you will finish with a Projects and a Tasks page as shown below: |
There was a problem hiding this comment.
Please replace "blog" with "tutorial".
|
|
||
|  | ||
|
|
||
| Clicking on a project it should send you to its Tasks page showing all tasks in this project. |
There was a problem hiding this comment.
Remove the word "it" before "should"
|
|
||
|  | ||
|
|
||
| ### Creating a data entity linking to the Projects endpoint. |
There was a problem hiding this comment.
For this and other steps, the verb should be in an active case "Create a data entity..." The step titles should instruct the user to DO something, not be in a state of DOING something. Thanks!
| ### Creating a data entity linking to the Projects endpoint. | ||
| In the last tutorial you saw how to create a simple data entity linking to your main API. Here you will create a new one and link it to your projects endpoint. | ||
|
|
||
| In the last tutorial you also enabled the SAP BTP Authentication necessary for the next steps. |
There was a problem hiding this comment.
Remove "In the last tutorial" and move this to follow the previous sentence.
|
|
||
| In the last tutorial you also enabled the SAP BTP Authentication necessary for the next steps. | ||
|
|
||
| Navigate to the data tab at the top of the page. There you will be able to click on “Create Data Entity” and choose “Sap BTP Destination REST API integration”. After having done this a configuration tab for your data entity should open: |
There was a problem hiding this comment.
You should use a numbered list starting here. I count four sub-steps in this step.
You can also remove statements like, "There you will be able to" Just start with the directive "Click on"
|
|
||
|  | ||
|
|
||
| Once on this page you need to choose the BTP destination name to link it to your Sap Cloud ALM API destination: |
There was a problem hiding this comment.
Remove "Once on this page you need to" and start with "Choose" or "On this page, choose"
|  | ||
|
|
||
|
|
||
| ### Creating the Data Variable |
|
|
||
|  | ||
|
|
||
| In the top right of the page, you select the variable view. you then click on Data variables. Here you can create variables in your page that will let us interact with your data entity. This will allow us to call your defined operations in that entity. |
There was a problem hiding this comment.
Start with "Select the variable view"
| You now have a link to your API and a way to access it on your Page. Next, you should create a list that will show all the Projects. | ||
|
|
||
|
|
||
| ### Creating the Projects list |
|  | ||
|
|
||
|
|
||
| ### Linking the Project page and the Task Page |
No description provided.