diff --git a/BuildServices.asciidoc b/BuildServices.asciidoc
index b6e16e2..54b1d11 100644
--- a/BuildServices.asciidoc
+++ b/BuildServices.asciidoc
@@ -125,7 +125,7 @@ matrix:
 
   allow_failures:
     # Ignore failures when building against the devel Nim branch
-    # Also ignore OSX, due to very long build time
+    # Also ignore OSX, due to very long build queue
     - env: CHANNEL=devel
     - os: osx
   fast_finish: true
@@ -137,7 +137,7 @@ addons: # This will only be executed on Linux
       - libyourdependency
 
 before_install:
-  # On MacOS flame/blis can be tested as it is an homebrew package
+  # If you want to install an OSX Homebrew dependency
   - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then brew update          ; fi
   - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then brew install libyourdependency; fi
 ## END: Assuming you rely on external dependencies