1
0
forked from docs/docsportal

adding more screenshots and text

This commit is contained in:
Hasko, Vladimir 2023-02-19 22:40:40 +00:00
parent 3f21647409
commit a075b097ca
12 changed files with 39 additions and 6 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 118 KiB

View File

@ -3,3 +3,5 @@ How can we accept the entire document when we are fine with it? Who will have th
====================================================================================================================
See the last option in :ref:`Previous question <how_can_we_revert_back_to_a_previous_document_version>`. This can be delegated to different person chosen by squad.
Also please refer for more details in :ref:`general change process flow <documentation_change_process>`.

View File

@ -3,3 +3,6 @@ How does the full document review workflow look like end-to-end on a high level?
================================================================================
The process of the Documentation Change Process under the following link: `https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Process <https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Process>`_ .
The more detailed description of the QA/UAT document review under the following link: `https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review <https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review>`_ .

View File

@ -2,4 +2,7 @@
How the document traceability to DMs/RMs in JIRA will work, who will be the responsible to place the links in the related JIRA ticket?
======================================================================================================================================
Huawei is responsible to do that in Huawei Documentation Delivery task in RM
Huawei is responsible to provide link to Gitea pull request in Huawei Documentation Delivery task in RM:
.. figure:: /_static/images/jira_document_pr_link.png

View File

@ -4,4 +4,11 @@ How to add a comment for a text or an image?
As natively in Gitea/Github any change in PR can be raised as a comment and can become subject for requesting the change
Adding a comment is a simple thing as described on the following link: `https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review#adding_comments <https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review#adding_comments>`_ .
Adding a comment for an image is not possible directly as shown on previous link but can be done simply at Conversation tab.
In case you want to comment something not being subject of change in PR but still valuable to comment (other part of documentation) you can raise an issue for that.

View File

@ -1,7 +1,21 @@
=============================================================================
============================================================================
How to compare the content of a change with the base (modified text/images)?
=============================================================================
============================================================================
Gitea/Github natively support the comparison between the diffs and new PR is nothing else just a diff to a base. Additionally in case of upcoming next commits in existing PR (follow-up updates from Huawei based on QA/UAT reviews) you can see even differences between the commits of the same PR. It means seeing latest changes from Huawei against previous changes in same PR.
Gitea/Github natively support the comparison between the diffs and new PR is nothing else just a diff to a base. Text comparison is represented as a "red" (removals) and "green" (addons) highlighted changes as shown on the image below:
.. figure:: /_static/images/compare_text.png
Image comparison offers multiple options how to visualize changes. The most common is side by side comparison:
.. figure:: /_static/images/compare_images.png
In case there are only added changes or the whole new files are added then the whole file is highlighted by green color:
.. figure:: /_static/images/added_new_text.png
Gitea/Github also natively support comparison changes between the multiple commits inside of the single pull request. For example follow-up updates from Huawei based on QA/UAT reviews are represented as multiple commits in same PR. The differences between the commits can be seen by clicking on the respecitve commit which will show the differences against the previous commit.
.. figure:: /_static/images/compare_commits.png
Images are also shown side by side in case of changes for easy comparison.

View File

@ -9,3 +9,6 @@ After finishing the review (and raising the comments) you have 3 options how to
- **Comment** - Raising the comments without explicit requirement of any changes (not blocking approval)
- **Request Changes** - Approval is not given and PR is blocked by requesting the changes which means that PR should receive another commit of changes and only after that PR will be ready for next review round
You can see further details at following link: `https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review#finish_review <https://gitea.eco.tsi-dev.otc-service.com/docs/docsportal/wiki/Review#finish_review>`_ .

View File

@ -1,3 +1,4 @@
.. _documentation_change_process:
Documentation Change Process
============================