Skip to content

Commit 66a0436

Browse files
authored
feat(docs): add section on managing repo categories (#156)
1 parent b2452a0 commit 66a0436

File tree

1 file changed

+48
-1
lines changed

1 file changed

+48
-1
lines changed

source/dashboard.rst

+48-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Dashboard
44
=========
55

6-
The dashboard contains the most common tasks, recently opened repositories and categories (favourites).
6+
The Dashboard contains the most common tasks, recently opened repositories and categories (favourites).
77
Categories can be added, grouped in the repository context menu.
88

99
.. image:: /images/dashboard/start_page.png
@@ -62,3 +62,50 @@ Clone Github repository
6262
-----------------------
6363

6464
See :doc:`github`.
65+
66+
Organizing your repositories with categories
67+
--------------------------------------------
68+
69+
Over time, the list of repositories you deal with can grow long. As it does, it can become difficult to
70+
find a repository you are looking for in the "Recent repositories" list when you have opened many other
71+
repositories since you opened the one you are looking for. To help find repositories quickly, you can
72+
group your repositories into categories that will display in alphabetical order on the Dashboard.
73+
74+
Create new category
75+
^^^^^^^^^^^^^^^^^^^
76+
77+
While the Dashboard is being displayed (after application start-up), you create a new repository category
78+
by doing the following:
79+
80+
- right click the repository you want to group into a category,
81+
- select "Categories",
82+
- select "Add new..." from the resulting submenu,
83+
- type the name of the new category,
84+
- click the [OK] button.
85+
86+
The originally-right-clicked repository will now additionally appear in your new category (repository group),
87+
where you can quickly find it again later no matter where it appears in the "Recent repositories" list.
88+
89+
Rename a category
90+
^^^^^^^^^^^^^^^^^
91+
92+
If you later decide you want a category to have a different name:
93+
94+
- click the "Actions" menu to the right of that category,
95+
- select "Rename category",
96+
- edit the current name to the new name you want,
97+
- click the [OK] button.
98+
99+
Your category will now show its new name, and be sorted among the other categories accordingly.
100+
101+
Delete a category
102+
^^^^^^^^^^^^^^^^^
103+
104+
When you no longer need a category:
105+
106+
- click the "Actions" menu to the right of that category,
107+
- select "Delete category",
108+
- read the warning displayed (deleting a category cannot be undone),
109+
- click the [Yes] button to delete it, or [No] to preserve it.
110+
111+
If you clicked [Yes], the selected category will no longer be displayed on the Dashboard.

0 commit comments

Comments
 (0)