@@ -10,8 +10,9 @@ to change `HEAD`, the default branch), prepares for [integration with a

 webserver][] (including acting as a [`git-http-backend`][] replacement, serving

 repos without the `.git` suffix, and generating

 [`$GIT_DIR`][]`/`[`README.html`][] and [`$GIT_DIR`][]`/`[`description`][] if

-[pandoc][] is available), allows [custom local code][], and prepares for [easy

-usage][`git-multihook`] of [custom local hooks][].

+[pandoc][] is available), allows [custom local code][], prepares for [easy

+usage][`git-multihook`] of [custom local hooks][], and prepares for integration

+with [Jenkins][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -33,6 +34,7 @@ usage][`git-multihook`] of [custom local hooks][].

 [custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

 [`git-multihook`]: https://git.rcrnstn.net/rcrnstn/git-multihook

 [custom local hooks]: https://gitolite.com/gitolite/cookbook#adding-other-non-update-hooks

+[Jenkins]: https://www.jenkins.io

 ## Try out

@@ -9,9 +9,9 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 to change `HEAD`, the default branch), prepares for [integration with a

 webserver][] (including acting as a [`git-http-backend`][] replacement, serving

 repos without the `.git` suffix, and generating

-[`$GIT_DIR`][]`/`[`README.html`][] if [pandoc][] is available), allows [custom

-local code][], and prepares for [easy usage][`git-multihook`] of [custom local

-hooks][].

+[`$GIT_DIR`][]`/`[`README.html`][] and [`$GIT_DIR`][]`/`[`description`][] if

+[pandoc][] is available), allows [custom local code][], and prepares for [easy

+usage][`git-multihook`] of [custom local hooks][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -28,6 +28,7 @@ hooks][].

 [`git-http-backend`]: https://git-scm.com/docs/git-http-backend

 [`$GIT_DIR`]: https://www.git-scm.com/docs/git#Documentation/git.txt-codeGITDIRcode

 [`README.html`]: https://git-scm.com/docs/gitweb#Documentation/gitweb.txt-READMEhtml

+[`description`]: https://git-scm.com/docs/gitweb#Documentation/gitweb.txt-descriptionorcodegitwebdescriptioncode

 [pandoc]: https://pandoc.org

 [custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

 [`git-multihook`]: https://git.rcrnstn.net/rcrnstn/git-multihook

@@ -7,9 +7,11 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

 to change `HEAD`, the default branch), prepares for [integration with a

-webserver][] (including acting as a [`git-http-backend`][] replacement, and

-serving repos without the `.git` suffix), allows [custom local code][], and

-prepares for [easy usage][`git-multihook`] of [custom local hooks][].

+webserver][] (including acting as a [`git-http-backend`][] replacement, serving

+repos without the `.git` suffix, and generating

+[`$GIT_DIR`][]`/`[`README.html`][] if [pandoc][] is available), allows [custom

+local code][], and prepares for [easy usage][`git-multihook`] of [custom local

+hooks][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -24,6 +26,9 @@ prepares for [easy usage][`git-multihook`] of [custom local hooks][].

 [`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

 [integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

 [`git-http-backend`]: https://git-scm.com/docs/git-http-backend

+[`$GIT_DIR`]: https://www.git-scm.com/docs/git#Documentation/git.txt-codeGITDIRcode

+[`README.html`]: https://git-scm.com/docs/gitweb#Documentation/gitweb.txt-READMEhtml

+[pandoc]: https://pandoc.org

 [custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

 [`git-multihook`]: https://git.rcrnstn.net/rcrnstn/git-multihook

 [custom local hooks]: https://gitolite.com/gitolite/cookbook#adding-other-non-update-hooks

@@ -8,7 +8,8 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

 to change `HEAD`, the default branch), prepares for [integration with a

 webserver][] (including acting as a [`git-http-backend`][] replacement, and

-serving repos without the `.git` suffix), and allows [custom local code][].

+serving repos without the `.git` suffix), allows [custom local code][], and

+prepares for [easy usage][`git-multihook`] of [custom local hooks][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -24,6 +25,8 @@ serving repos without the `.git` suffix), and allows [custom local code][].

 [integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

 [`git-http-backend`]: https://git-scm.com/docs/git-http-backend

 [custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

+[`git-multihook`]: https://git.rcrnstn.net/rcrnstn/git-multihook

+[custom local hooks]: https://gitolite.com/gitolite/cookbook#adding-other-non-update-hooks

 ## Try out

@@ -7,8 +7,8 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

 to change `HEAD`, the default branch), prepares for [integration with a

-webserver][] (including acting as a [`git-http-backend`][] replacement), and

-allows [custom local code][].

+webserver][] (including acting as a [`git-http-backend`][] replacement, and

+serving repos without the `.git` suffix), and allows [custom local code][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -6,8 +6,9 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 `git`), prepares for [administering gitolite directly on the server][], allows

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

-to change `HEAD`, the default branch), and prepares for [integration with a

-webserver][] (including acting as a [`git-http-backend`][] replacement).

+to change `HEAD`, the default branch), prepares for [integration with a

+webserver][] (including acting as a [`git-http-backend`][] replacement), and

+allows [custom local code][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -22,6 +23,7 @@ webserver][] (including acting as a [`git-http-backend`][] replacement).

 [`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

 [integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

 [`git-http-backend`]: https://git-scm.com/docs/git-http-backend

+[custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

 ## Try out

@@ -7,7 +7,7 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

 to change `HEAD`, the default branch), and prepares for [integration with a

-webserver][].

+webserver][] (including acting as a [`git-http-backend`][] replacement).

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -21,6 +21,7 @@ webserver][].

 [personal branches]: https://gitolite.com/gitolite/user#personal-branches

 [`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

 [integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

+[`git-http-backend`]: https://git-scm.com/docs/git-http-backend

 ## Try out

@@ -5,8 +5,9 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 `git`), prepares for [administering gitolite directly on the server][], allows

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

-[personal branches][] for `USERS`, and allows users to run [`symbolic-ref`][]

-(e.g. to change `HEAD`, the default branch).

+[personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

+to change `HEAD`, the default branch), and prepares for [integration with a

+webserver][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -19,6 +20,7 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 [multiple `OWNERS`]: https://gitolite.com/gitolite/wild#specifying-owners

 [personal branches]: https://gitolite.com/gitolite/user#personal-branches

 [`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

+[integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

 ## Try out

@@ -3,9 +3,10 @@

 An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

-`git`), prepares for [administering gitolite directly on the server][], and

-allows (explicit) [user created repos][] with [multiple `OWNERS`][] and

-`user/USER/*` [personal branches][] for `USERS`.

+`git`), prepares for [administering gitolite directly on the server][], allows

+(explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

+[personal branches][] for `USERS`, and allows users to run [`symbolic-ref`][]

+(e.g. to change `HEAD`, the default branch).

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -17,6 +18,7 @@ allows (explicit) [user created repos][] with [multiple `OWNERS`][] and

 [user created repos]: https://gitolite.com/gitolite/odds-and-ends#giving-users-their-own-repos

 [multiple `OWNERS`]: https://gitolite.com/gitolite/wild#specifying-owners

 [personal branches]: https://gitolite.com/gitolite/user#personal-branches

+[`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

 ## Try out

@@ -4,8 +4,8 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 `git`), prepares for [administering gitolite directly on the server][], and

-allows [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

-[personal branches][] for `USERS`.

+allows (explicit) [user created repos][] with [multiple `OWNERS`][] and

+`user/USER/*` [personal branches][] for `USERS`.

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -4,7 +4,8 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 `git`), prepares for [administering gitolite directly on the server][], and

-allows [user created repos][] with [multiple `OWNERS`][].

+allows [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

+[personal branches][] for `USERS`.

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -15,6 +16,7 @@ allows [user created repos][] with [multiple `OWNERS`][].

 [administering gitolite directly on the server]: https://gitolite.com/gitolite/odds-and-ends#administering-gitolite-directly-on-the-server

 [user created repos]: https://gitolite.com/gitolite/odds-and-ends#giving-users-their-own-repos

 [multiple `OWNERS`]: https://gitolite.com/gitolite/wild#specifying-owners

+[personal branches]: https://gitolite.com/gitolite/user#personal-branches

 ## Try out

@@ -4,7 +4,7 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 `git`), prepares for [administering gitolite directly on the server][], and

-allows [user created repos][].

+allows [user created repos][] with [multiple `OWNERS`][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -14,6 +14,7 @@ allows [user created repos][].

 [dedicated user]: https://gitolite.com/gitolite/concepts#the-hosting-user

 [administering gitolite directly on the server]: https://gitolite.com/gitolite/odds-and-ends#administering-gitolite-directly-on-the-server

 [user created repos]: https://gitolite.com/gitolite/odds-and-ends#giving-users-their-own-repos

+[multiple `OWNERS`]: https://gitolite.com/gitolite/wild#specifying-owners

 ## Try out

@@ -3,7 +3,8 @@

 An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

-`git`), and prepares for [administering gitolite directly on the server][].

+`git`), prepares for [administering gitolite directly on the server][], and

+allows [user created repos][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -12,6 +13,7 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 [Debian]: https://www.debian.org

 [dedicated user]: https://gitolite.com/gitolite/concepts#the-hosting-user

 [administering gitolite directly on the server]: https://gitolite.com/gitolite/odds-and-ends#administering-gitolite-directly-on-the-server

+[user created repos]: https://gitolite.com/gitolite/odds-and-ends#giving-users-their-own-repos

 ## Try out

@@ -2,8 +2,8 @@

 An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

-Installs [gitolite][] and creates a [dedicated user][] to run it (defaults to

-`git`).

+Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

+`git`), and prepares for [administering gitolite directly on the server][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -11,6 +11,7 @@ Installs [gitolite][] and creates a [dedicated user][] to run it (defaults to

 [gitolite]: https://gitolite.com

 [Debian]: https://www.debian.org

 [dedicated user]: https://gitolite.com/gitolite/concepts#the-hosting-user

+[administering gitolite directly on the server]: https://gitolite.com/gitolite/odds-and-ends#administering-gitolite-directly-on-the-server

 ## Try out

@@ -2,13 +2,15 @@

 An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

-Installs [gitolite][].

+Installs [gitolite][] and creates a [dedicated user][] to run it (defaults to

+`git`).

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

 [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html

 [gitolite]: https://gitolite.com

 [Debian]: https://www.debian.org

+[dedicated user]: https://gitolite.com/gitolite/concepts#the-hosting-user

 ## Try out

@@ -2,6 +2,8 @@

 An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

+Installs [gitolite][].

+

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

 [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html

@@ -19,8 +19,13 @@ ansible-playbook -K -i $host, site.yml

 (note the comma!) replacing `$host` with the host you want to set up (can be

 `localhost`, perhaps adding `--connection=local`).

+A [`Vagrantfile`][] that uses it is also provided, try it out with the usual

+[`vagrant up`][].

+

 [`site.yml`]: site.yml

 [playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html

+[`Vagrantfile`]: Vagrantfile

+[`vagrant up`]: https://www.vagrantup.com/docs/cli/up.html

 ## License

@@ -8,6 +8,20 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 [gitolite]: https://gitolite.com

 [Debian]: https://www.debian.org

+## Try out

+

+A stand-in [`site.yml`][] [playbook][] is provided, use it with

+

+```

+ansible-playbook -K -i $host, site.yml

+```

+

+(note the comma!) replacing `$host` with the host you want to set up (can be

+`localhost`, perhaps adding `--connection=local`).

+

+[`site.yml`]: site.yml

+[playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html

+

 ## License

 Licensed under the [ISC License][] unless otherwise noted, see the

@@ -7,3 +7,11 @@ An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

 [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html

 [gitolite]: https://gitolite.com

 [Debian]: https://www.debian.org

+

+## License

+

+Licensed under the [ISC License][] unless otherwise noted, see the

+[`LICENSE`][] file.

+

+[ISC License]: https://choosealicense.com/licenses/isc/

+[`LICENSE`]: LICENSE

new file mode 100644

@@ -0,0 +1,9 @@

+# [`ansible-role-gitolite`][]

+

+An [Ansible][] [role][] for deploying [gitolite][] on [Debian][] >=9.

+

+[`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

+[Ansible]: https://docs.ansible.com/ansible

+[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html

+[gitolite]: https://gitolite.com

+[Debian]: https://www.debian.org