Feature/dops 1651/enable fork build

.github/_README.md

@@ -6,9 +6,23 @@ GitHub Actions CI for Iroha
 
 ---------------------
 
-USAGE
+### Workflows
+
+There are GitHub Actions Workflows called [`Iroha1`](build-iroha1.src.yml) and [`Iroha1-fork`](build-iroha1-fork.src.yml). 
+
+
+USAGE of Iroha1-fork
 -----
-GitHub Actions Workflow [`Iroha1`](build-iroha1.src.yml) solves task of automated build and deployment Iroha1.
+GitHub Actions Workflow [`Iroha1-fork`](build-iroha1-fork.src.yml) solves task of automated build and deployment of Iroha1 from forks.
+
+Runs on **pull request** from forks to Iroha1 main and development branches.
+
+The workflow is started on pull request creation or update. The workflow is paused on steps that require build of untrusted code. Maintainers are notified to review the code and allow build and deployment. 
+
+
+USAGE of Iroha1
+-----
+GitHub Actions Workflow [`Iroha1`](build-iroha1.src.yml) solves task of automated build and deployment Iroha1 from Hyperledger/iroha repository.
 There are events when it is running:
 - on **pull request** to Iroha1 main and development branches
 - on **push** to main or development branches including event when PR is **merged**
@@ -22,12 +36,17 @@ Default `buildspec` is _`/build all`_
 Build matrix is a way to select among number of configurations to be built.
 Build matrix is generated from buildspec string and handled by script [`chatops-gen-matrix.sh`](./chatops-gen-matrix.sh)
 
-## List of files
+List of files
+-----
 - `build-iroha1.src.yml`
   Main file here. GitHub workflow YAML description with ANCHORS, code is not duplicated.
-  IMPORTANT: regeneration required after after edit, which is automated with pre-commit.
+  IMPORTANT: regeneration required after edit, which is automated with pre-commit.
+- `build-iroha1-fork.src.yml`
+  Same as previous, but for forks
 - `workflows/build-iroha1.yml`
   Result worflow taken by GitHub and generated with make-workflows script. Long file of repeated code. DO NOT EDIT MANUALLY.
+- `workflows/build-iroha1.yml`
+  Same as previous, but for forks
 - `make-workflows.sh`
   A tool to generate workflows/*.yml from *.src.yml - evaluates anchors. [Read the docs](_README.make-workflows.md).
 - `chatops-gen-matrix.sh`
@@ -65,3 +84,9 @@ Build matrix is generated from buildspec string and handled by script [`chatops-
   See docs of make-workflows. Use instead of pre-commit as `ln -s ../../.github/pre-commit-hook.sh .git/hooks/pre-commit`, reserv alternative.
 - `TESTS_ALLOWED_TO_FAIL`
   One day tests of Iroha became failing. To fix CI and postpone fixing tests, this file was invented. It allows CI to pass even when listed tests are failing. DO NOT USE UNLESS YOU DEFINITELY KNOW WHAT'S GOING. KEEP IT EMPTY.
+
+Worth noting
+-----
+None of workflows run for PRs that update only .md and .rst files. As sourse code of Iroha and dependencies do not change, building and testing is redundant.
+
+Forks are not allowed to change `.github` folder, Dockerfiles and scripts in `docker` folder