Skip to content
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

Editorial updates of documentation QoD_API.md #76

Merged
merged 2 commits into from
Jan 3, 2023
Merged

Editorial updates of documentation QoD_API.md #76

merged 2 commits into from
Jan 3, 2023

Conversation

hdamker
Copy link
Collaborator

@hdamker hdamker commented Dec 21, 2022

After the content update for v0.8.0 with #71 here some editorial fixes within QoD_API.md, also to create a stable base for further updates/PRs:

  • Reformated some tables as HTML tables (to get rid of the overlong source code lines which couldn't be reviewed)
  • More consistent use of QoD vs QoS
  • Consistent use of "QoS session resource" instead "QoS session"
  • Consolidated mixed use of "mobile network operator" vs "communication service provider"
  • Some further minor typos

Will close #58

NOTE: this PR is not about correcting content issues (like error code etc), these should be raised as issues, especially if also the API definition YAML need to be changed

@hdamker
Copy link
Collaborator Author

hdamker commented Dec 21, 2022

@akoshunyadi @shilpa-padgaonkar @eric-murray @jlurien @jpengar @patrice-conil @SylMOREL @tlohmar: would be great if some of you can have a look and approve the changes. Also further suggestions for editorial changes/corrections are welcome.

@hdamker hdamker merged commit 7aa435c into camaraproject:main Jan 3, 2023
@hdamker hdamker deleted the QoD-API-Doc-editorial-fixes branch January 3, 2023 12:18
Copy link
Collaborator

@jlurien jlurien left a comment

Choose a reason for hiding this comment

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

  • Table formatting looks good.
  • createSession returns 201, not 200
  • Some suggestions for IPvX parameters

</tr>
<tr>
<td rowspan=7><b>Response</b></td>
<td><b>200: Session created</b></td>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<td><b>200: Session created</b></td>
<td><b>201: Session created</b></td>

<td>
<p>The identifier for the user equipment (device). The developer can choose to provide the below specified user equipment identifiers:</p>
<ul>
<li>IPv4 address (supports mask) e.g. 192.168.0.1/24</li>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<li>IPv4 address (supports mask) e.g. 192.168.0.1/24</li>
<li>ipv4addr: IPv4 address (supports mask) e.g. 192.168.0.1/24</li>

<p>The identifier for the user equipment (device). The developer can choose to provide the below specified user equipment identifiers:</p>
<ul>
<li>IPv4 address (supports mask) e.g. 192.168.0.1/24</li>
<li>ipv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344</li>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<li>ipv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344</li>
<li>ipv6addr: IPv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344</li>

<td>
<p>The identifier used for application server. The developer can choose from the below application server identifiers:</p>
<ul>
<li>ipv4 address (supports mask) e.g. 192.168.0.1/24</li>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<li>ipv4 address (supports mask) e.g. 192.168.0.1/24</li>
<li>ipv4addr: IPv4 address (supports mask) e.g. 192.168.0.1/24</li>

<p>The identifier used for application server. The developer can choose from the below application server identifiers:</p>
<ul>
<li>ipv4 address (supports mask) e.g. 192.168.0.1/24</li>
<li>ipv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<li>ipv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344
<li>ipv6addr: IPv6 address (supports mask) e.g. 2001:db8:85a3:8d3:1319:8a2e:370:7344

@jlurien
Copy link
Collaborator

jlurien commented Jan 3, 2023

@hdamker I see you have just merged this branch. At least we should correct 201 for createSession, other suggestions are more cosmetic

@hdamker
Copy link
Collaborator Author

hdamker commented Jan 3, 2023

@jlurien thanks for your comments, will change them within a new PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation minor QoD
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update of API documentation
3 participants