Merge branch 'feature/manual-docs' into 'master'

docs can be manually refreshed

See merge request wpdesk/gitlab-ci!70

gitlab-ci-1.2.yml

@@ -100,6 +100,21 @@ stages:
   only:
     - tags
 
+.template: &docs-generation
+  image:
+    name: wpdesknet/apigen
+  stage: pre-deploy
+  artifacts:
+    expire_in: 1 day
+    name: "docs"
+    paths:
+      - docs/
+  script:
+    - echo ${WPDESK_CI_VERSION}
+    - ls -l
+    - /app/vendor/bin/apigen generate
+    - php /app/hooks-docs.php ${CI_PROJECT_DIR}
+
 before_script:
   - cd ${CI_PROJECT_DIR}
 
@@ -238,23 +253,15 @@ integration test current woocommerce:
       - $DISABLE_INTEGRATION_TESTS
 
 apigen docs:
-  image:
-    name: wpdesknet/apigen
-  stage: pre-deploy
-  artifacts:
-    expire_in: 1 day
-    name: "docs"
-    paths:
-      - docs/
+  <<: *docs-generation
   allow_failure: true
-  script:
-    - echo ${WPDESK_CI_VERSION}
-    - ls -l
-    - /app/vendor/bin/apigen generate
-    - php /app/hooks-docs.php ${CI_PROJECT_DIR}
   only:
     - tags
 
+apigen docs refresh:
+  <<: *docs-generation
+  when: manual
+
 pages:
   stage: deploy
   dependencies: