forked from docs/docsportal
adding more screenshots and text
This commit is contained in:
parent
3f21647409
commit
a075b097ca
BIN
doc/source/_static/images/added_new_text.png
Executable file
BIN
doc/source/_static/images/added_new_text.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 32 KiB |
BIN
doc/source/_static/images/compare_commits.png
Executable file
BIN
doc/source/_static/images/compare_commits.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 72 KiB |
BIN
doc/source/_static/images/compare_images.png
Executable file
BIN
doc/source/_static/images/compare_images.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 50 KiB |
BIN
doc/source/_static/images/compare_text.png
Executable file
BIN
doc/source/_static/images/compare_text.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 55 KiB |
BIN
doc/source/_static/images/jira_document_pr_link.png
Executable file
BIN
doc/source/_static/images/jira_document_pr_link.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 118 KiB |
@ -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>`.
|
||||
|
@ -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>`_ .
|
||||
|
||||
|
@ -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
|
||||
|
||||
|
@ -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.
|
||||
|
||||
|
||||
|
||||
|
@ -1,7 +1,21 @@
|
||||
=============================================================================
|
||||
How to compare the content of a change with the base (modified text/images)?
|
||||
=============================================================================
|
||||
============================================================================
|
||||
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.
|
||||
|
@ -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>`_ .
|
||||
|
||||
|
@ -1,3 +1,4 @@
|
||||
.. _documentation_change_process:
|
||||
|
||||
Documentation Change Process
|
||||
============================
|
||||
|
Loading…
x
Reference in New Issue
Block a user