README.md in pra-1.2.0 vs README.md in pra-1.3.0

- old
+ new

@@ -19,15 +19,10 @@ directory. The following is an example config that can be used as a starter. *Note:* You will need to replace **your.username**, **your.password**, **your.stash.server**, and the **repositories** sections of each of the pull sources. -#### Assignee Blacklist - -Reduces noise to more easily determine which pull requests are unassigned. Names -added will not appear in the assignee column. - { "pull_sources": [ { "type": "stash", "config": { @@ -35,10 +30,11 @@ "host": "your.stash.server", "username": "your.username", "password": "your.password", "repositories": [ { "project_slug": "CAP", "repository_slug": "capture_api" }, + { "user_slug": "bob.villa", "repository_slug": "personal_notes" }, { "project_slug": "RELENG", "repository_slug": "ramboo" } ] } }, { @@ -63,9 +59,28 @@ I suggest copying and pasting the above starter file into your `~/.pra.json` file to get you started. Then simply replace the appropriate fields and the **repositories** sections for all the pull sources with the repository information for the repositories you want to watch for open pull requests. + +#### Stash User & Project Repositories + +You may have noticed that the above example shows two repository objects in its +Stash **repositories** array. + +1. Project Scoped Repository - `{ "project_slug": "CAP", "repository_slug": "capture_api" },` +2. User Scoped Repository - `{ "user_slug": "bob.villa", "repository_slug": "personal_notes" },` + +This is because Stash has both the concept of repsositories that are organized +under Projects and repositories that are organized under Users. Therefore, you +would want to use the **User Scoped Repository** in scenarios where the +repository is housed under a user and the **Project Scoped Repository** in +scenarios where the repository is housed under a project. + +#### Assignee Blacklist + +Reduces noise to more easily determine which pull requests are unassigned. Names +added will not appear in the assignee column. ### GitHub Authentication #### Multi-Factor Authentication