write docs

Author: andreibarabas

.semaphore/semaphore.yml

@@ -41,6 +41,11 @@ blocks:
           # complete in about a second.
           # See https://docs.semaphoreci.com/article/68-caching-dependencies
           - cache restore
+
+          # Fix for: `find_spec_for_exe': can't find gem bundler erro
+          # Look at the end of Gemfile.lock, under BUNDLED WITH
+          # and simply install the required version before calling bundle install
+          - gem install bundler -v '2.1.4'
           - bundle install --path vendor/bundle
           - cache store
       jobs:
@@ -60,22 +65,25 @@ blocks:
       env_vars:
         - name: LANG
           value: en_US.UTF-8
-      #secrets:
+      secrets:
         # Make the SSH key for the certificate repository and the MATCH_PASSWORD
         # environment variable available.
         # See https://docs.semaphoreci.com/article/109-using-private-dependencies
-      #  - name: match-secrets
+        - name: match-secrets
       prologue:
         commands:
           # Add the key for the match certificate repository to ssh
           # See https://docs.semaphoreci.com/article/109-using-private-dependencies
-          #- chmod 0600 ~/.ssh/*
-          #- ssh-add ~/.ssh/match-repository-private-key
+          - chmod 0600 ~/.ssh/*
+          - ssh-add ~/.ssh/match-repository-private-key
           # Continue with checkout as normal
           - checkout
           - cache restore
-          # Just in case you hit into this 
-          # https://bundler.io/blog/2019/01/04/an-update-on-the-bundler-2-release.html
+          
+
+          # Fix for: `find_spec_for_exe': can't find gem bundler erro
+          # Look at the end of Gemfile.lock, under BUNDLED WITH
+          # and simply install the required version before calling bundle install
           - gem install bundler -v '2.1.4'
           - bundle install --path vendor/bundle
           - cache store
@@ -97,19 +105,20 @@ blocks:
         commands:
           - checkout
           - cache restore
-          # Just in case you hit into this 
-          # https://bundler.io/blog/2019/01/04/an-update-on-the-bundler-2-release.html
+          
+          # Fix for: `find_spec_for_exe': can't find gem bundler erro
+          # Look at the end of Gemfile.lock, under BUNDLED WITH
+          # and simply install the required version before calling bundle install
           - gem install bundler -v '2.1.4'
           - bundle install --path vendor/bundle
           - cache store
       jobs:
         - name: Screenshots
           commands:
             - bundle exec xcversion select 12.2
-            # snapshot seems to sometimes be an issue with fastlane snapshot finding the simular. see runs:
-            # https://traynt.semaphoreci.com/jobs/99773826-f05a-4080-8555-b8515c7d5e90
-            # https://traynt.semaphoreci.com/jobs/e17cea1f-7be4-4736-97a8-7f5e8433c975
-            # thus running first the xcode tools to list the available simulators seems to work
+
+            # Fix for fastlane snapshot not allways finding the simular.
+            # In case you find errors like "Simulator not found", use this workarround
             - xcrun simctl list
 
             - bundle exec fastlane screenshots

README.md

@@ -83,6 +83,19 @@ Then, just push any change to your fork of this project and Semaphore will run t
 
 This example Semaphore configuration uses an `a1-standard-4` machine running macOS Mojave with [Xcode 11, fastlane and other build tools pre-installed](https://docs.semaphoreci.com/ci-cd-environment/macos-catalina-xcode-11-image/). Other, larger machine types are [available if needed](https://docs.semaphoreci.com/ci-cd-environment/machine-types/).
 
+## Fork-and-Run VS Master branch
+
+The `master` branch represents a template you can follow to setup your own project on Semaphore. That being said, running it directly on your own account would require first setting the public/private keys as describe in the [Run the CI pipeline on Semaphore](#run-the-ci-pipeline-on-semaphore) section.
+
+For simplicity, on the `fork-and-run` branch we disabled the signing capabilities of this template project so you can safely `fork` and imediatelly `run` it on Semaphore.
+
+The lines that have been commented out for this purpose are clearly marked as 
+
+```##### Disable code signing for fork-and-run branch ######```
+
+so you can clearly see what has been removed.
+
+
 ## License
 
 Copyright ©2019 Rendered Text – Distributed under the MIT License. See the [LICENSE](LICENSE) for full terms.