update docs

source/ci_source/providers/Screwdriver.ts

@@ -4,20 +4,27 @@ import { ensureEnvKeysExist, ensureEnvKeysAreInt } from "../ci_source_helpers"
 /**
  * ### CI Setup
  *
- * With BuildKite you run the server yourself, so you will want to run  it as a part of your build process.
- * It is common to have build steps, so we would recommend adding this to your scrip:
- *
- *  ``` shell
- *   echo "--- Running Danger"
- *   bundle exec danger
- *  ```
+ * Install dependencies and add a danger step to your screwdriver.yaml:
+ * ``` yml
+ * jobs:
+ *   danger:
+ *     requires: [~pr, ~commit]
+ *     steps:
+ *       - setup: yarn install
+ *       - danger: yarn danger ci
+ *     secrets:
+ *       - DANGER_GITHUB_API_TOKEN
+ * ```
  *
  * ### Token Setup
  *
+ * Add the `DANGER_GITHUB_API_TOKEN` to your pipeline env as a
+ * [build secret](https://docs.screwdriver.cd/user-guide/configuration/secrets)
+ *
  * #### GitHub
  *
  * As this is self-hosted, you will need to add the `DANGER_GITHUB_API_TOKEN` to your build user's ENV. The  alternative
- * is to pass in the token as a prefix to the command `DANGER_GITHUB_API_TOKEN="123" bundle exec danger`.
+ * is to pass in the token as a prefix to the command `DANGER_GITHUB_API_TOKEN="123" yarn danger ci`.
  */
 export class Screwdriver implements CISource {
   constructor(private readonly env: Env) {}