From 2e31d6d894feed09f3cbbb5a1a07f7ac998f65d8 Mon Sep 17 00:00:00 2001
From: eliska-n <eliska.novotna@teskalabs.com>
Date: Wed, 26 Jul 2023 12:09:24 +0200
Subject: [PATCH 1/2] branch option in the gitprovider

---
 doc/asab/library.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/asab/library.rst b/doc/asab/library.rst
index fb31b72d6..bd7b3f6a4 100644
--- a/doc/asab/library.rst
+++ b/doc/asab/library.rst
@@ -302,6 +302,14 @@ Configuration:
 	providers: git+https://github.com/john/awesome_project.git
 
 
+Use hash `#<branch-name>` to clone a repository from a selected branch.
+
+.. code:: ini
+
+	[library]
+	providers: git+https://github.com/john/awesome_project.git#name-of-the-branch
+
+
 Deploy tokens in GitLab
 ~~~~~~~~~~~~~~~~~~~~~~~
 GitLab uses deploy tokens to enable authentication of deployment tasks, independent of a user account.

From 48697db6d776135fe08994e8e17c876abc4963b3 Mon Sep 17 00:00:00 2001
From: eliska-n <eliska.novotna@teskalabs.com>
Date: Wed, 26 Jul 2023 12:30:44 +0200
Subject: [PATCH 2/2] adding general format

---
 doc/asab/library.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/doc/asab/library.rst b/doc/asab/library.rst
index bd7b3f6a4..04ae2c868 100644
--- a/doc/asab/library.rst
+++ b/doc/asab/library.rst
@@ -296,13 +296,23 @@ Connection to git repositories requires `pygit2 <https://www.pygit2.org/>`_ libr
 
 Configuration:
 
+Please follow this format in the configuration:
+
+.. code:: ini
+
+	[library]
+	providers: git+http(s)://<username>:<deploy-token>@<path>#<branch
+
+
+Using a public repository from github, the configuration may look like this: 
+
 .. code:: ini
 
 	[library]
 	providers: git+https://github.com/john/awesome_project.git
 
 
-Use hash `#<branch-name>` to clone a repository from a selected branch.
+Use hash `#<branch-name>` to clone a repository from a selected branch:
 
 .. code:: ini