Merge branch 'pgulutzan-gh-2516' of github.com:tarantool/doc into pgulutzan-gh-2516

Author: patiencedaur

.github/ISSUE_TEMPLATE/document.md

@@ -1,20 +1,17 @@
 ---
-name: Write or Update
+name: Write or update
 about: Write or update a documentation page
-title: "[0pt] {feature_name}"
+title: "{feature_name}"
 labels: 
 assignees:
 ---
-# Feature name
-
-Fill in whatever you know at the moment.
+**Related dev. issue(s):** GitHub link(s)
 
 **Product:** Tarantool, Cartridge, TDG, connectors, tools?
 **Since:** product version
 **Audience/target:** who will read it and for what task?
 **Root document:** where to add or update documentation
 **SME:** @ expert to ask for more information
-**Peer reviewer:** @ documentarian name
 
 # Details
 
@@ -43,4 +40,4 @@ Fill in whatever you know at the moment.
 - [ ] Estimate complexity in storypoints in the title
 - [ ] Add to **Documentation** board → **Backlog**
 
-> Note: issue templates are in beta. Give your feedback in #1869.
+> Note: issue templates are in beta. Give your feedback in #1869.

.github/ISSUE_TEMPLATE/epic.md

@@ -0,0 +1,17 @@
+---
+name: Epic
+about: Create an umbrella ticket for future release documentation
+title: "[Epic] {epic_name}"
+labels: epic
+assignees:
+---
+**Related dev. epic:** GitHub link
+**PM ref.:** Notion link
+**SME:** @ expert to ask for more information
+
+# Details
+
+- [ ] GitHub issue
+- [ ] GitHub issue
+
+Provide any details you consider necessary.

.github/ISSUE_TEMPLATE/fix.md

@@ -1,7 +1,7 @@
 ---
-name: Fix & Proofread
+name: Fix & proofread
 about: Fix typos, proofread document
-title: "[0pt] Fix {document_title}"
+title: "Fix {document_title}"
 labels: typo
 assignees:
 ---

.github/ISSUE_TEMPLATE/tech.md

@@ -1,7 +1,7 @@
 ---
 name: Technical/internal issue
-about: Technical debt in the docs
-title: "[0pt] {do X}"
+about: Technical issue in the docs
+title: "{do X}"
 labels: internal
 assignees:
 ---
@@ -16,11 +16,8 @@ assignees:
 
 # Planning checklist
 
-- [ ] Pick label:
-  - [CI/CD](https://github.com/tarantool/doc/labels/CI/CD)
-  - [localization](https://github.com/tarantool/doc/labels/localization)
-  - or others.  
+- [ ] Pick a label
 - [ ] Estimate complexity in storypoints in the title
 - [ ] Add to **Documentation** board → **Backlog**
 
-> Note: issue templates are in beta. Give your feedback in #1869.
+> Note: issue templates are in beta. Give your feedback in #1869.

.github/ISSUE_TEMPLATE/tech_debt_epic.md

@@ -0,0 +1,14 @@
+---
+name: Technical debt epic
+about: Umbrella ticket for technical debt in the docs 
+title: "[Tech debt] {epic_name}"
+labels: epic
+assignees:
+---
+
+# Details
+
+- [ ] GitHub issue
+- [ ] GitHub issue
+
+Provide any details you consider necessary.

.github/ISSUE_TEMPLATE/translate.md

@@ -48,4 +48,4 @@ jobs:
           token: ${{secrets.GITHUB_TOKEN}}
           status: ${{job.status}}
           deployment_id: ${{steps.deployment.outputs.deployment_id}}
-          env_url: ${{secrets.TARANTOOL_HOST}}/doc/${{env.BRANCH_NAME}}
+          env_url: ${{secrets.TARANTOOL_HOST}}/doc/${{env.BRANCH_NAME}}/

.github/ISSUE_TEMPLATE/versions.md

@@ -32,8 +32,6 @@ jobs:
       - run: make build-modules
       - run: make json
       - run: make json-ru
-      - run: make singlehtml
-      - run: make singlehtml-ru
       - run: make pdf
       - run: make pdf-ru
       - uses: nelonoel/[email protected]

.github/workflows/deploy-branch.yml

@@ -19,7 +19,7 @@ jobs:
       - uses: actions/checkout@v2
         with:
           token: "${{ secrets.TARANTOOLBOT_TOKEN }}"
-          fetch-depth: 2
+          fetch-depth: 0
 
       - name: Set branch name from source branch
         run: echo "BRANCH_NAME=${GITHUB_REF##*/}" >> $GITHUB_ENV
@@ -47,15 +47,20 @@ jobs:
         run: make cleanup-po
 
       - name: Set $CHANGED_POS for changed .rst files only
-        run: echo "CHANGED_POS=$(echo "$(git diff --name-only | grep .po | sed "s/.po//" | sed "s/locale\/ru\/LC_MESSAGES\///")" | awk -v rst="$(git diff-tree --no-commit-id --name-only -r HEAD | grep .rst | tr "\n" " ")" 'rst ~ $0{ print "locale/ru/LC_MESSAGES/"$0".po" }')" >> $GITHUB_ENV
+        shell: bash
+        run: |
+          set -x
+          . list_changed_po.sh
+          if [ -z "${CHANGED_POS}" ]; then exit 1; fi
+          echo "CHANGED_POS=${CHANGED_POS}" >> $GITHUB_ENV
         if: ${{github.event.inputs.commit_po_for_unchanged_rst == 'false'}}
 
       - name: Set $CHANGED_POS for all .rst files
-        run: echo "CHANGED_POS=.po" >> $GITHUB_ENV
+        run: echo "CHANGED_POS=*.po" >> $GITHUB_ENV
         if: ${{github.event.inputs.commit_po_for_unchanged_rst != 'false'}}
 
       - name: Commit translation files
-        uses: stefanzweifel/git-auto-commit-action@v4.1.2
+        uses: stefanzweifel/git-auto-commit-action@v4.12.0
         with:
           commit_message: "Update translations"
           file_pattern: "${{ env.CHANGED_POS }}"

.github/workflows/main.yml

@@ -1,7 +1,7 @@
 name: Push translation sources
 
 on:
-  pull_request:
+  workflow_dispatch:
     paths:
       - 'doc/**/*.rst'
       - 'conf.py'
@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v2
 
       - name: Set branch name from source branch
-        run: echo "BRANCH_NAME=${GITHUB_HEAD_REF##*/}" >> $GITHUB_ENV
+        run: echo "BRANCH_NAME=${GITHUB_REF##*/}" >> $GITHUB_ENV
 
       - name: Start translation service deployment
         uses: bobheadxi/[email protected]

.github/workflows/pull-translation.yml

@@ -7,6 +7,7 @@ locale/**/*.mo
 _*_build/
 deploy_key
 .venv
+venv
 output
 *.pyc
 _theme/tarantool/static/design.css.map

.github/workflows/push-translation.yml

@@ -240,7 +240,7 @@ add_custom_target(update-pot
     COMMENT "Update translation sources"
 )
 
-add_custom_target(update-po-no-force
+add_custom_target(update-po
     COMMAND "${SPHINX_INTL_EXECUTABLE}"
         update
         -p "${CMAKE_CURRENT_SOURCE_DIR}/locale/en/"
@@ -267,13 +267,6 @@ add_custom_target(cleanup-pot
     COMMENT "Cleanup and rearrange POT files"
 )
 
-add_custom_target(update-po
-    COMMAND make
-        add-fake-msg
-        update-po-no-force
-        rm-fake-msg
-)
-
 add_custom_target(linkcheck
     COMMAND "${SPHINX_EXECUTABLE}"
         -b linkcheck