Projects
A project is a set of repositories that you group under one name, such as an app, its infrastructure and its plugins. Grouped by project, the inbox and the sidebar show the reviews and the sessions of all its repositories together. A repository belongs to at most one project.
Agents know nothing of projects. A review or a session names its repository, and Pinrail shows it under the project that repository is in. Adding a repository to a project also moves its earlier reviews and sessions there.
The Projects page
Section titled “The Projects page”Open Projects in the sidebar. The page lists the projects by name. Each project shows what waits in it, its sessions and its latest activity, with its repositories under it. In no project lists every other repository that sent a review or a session.
- Create a project with New project. Give it a name and, if you like, a description, a colour and an icon: an emoji, or up to three letters. Without an icon, the project’s avatar shows the first letter of its name.
- Add a repository by dragging it under a project. Drag it under In no project to take it out again. The … button at the end of a repository’s row also moves it, or starts a new project with it.
- Change a project with Edit… in the … menu of its heading. Delete project… removes the project and nothing else: its repositories are in no project again, and their reviews and sessions stay as they are.
- Change a repository’s key prefix with Change key prefix… in its … menu. The prefix begins the keys of the repository’s work items, such as
PIN-42, and is two to five capital letters. The old keys still find the items. - Delete a repository with Delete repository… in its … menu. This deletes all of its work items, reviews, questions and sessions, including those in the history, and cannot be undone. Reviews and questions that still wait are discarded first, so the agents waiting on them are told to stop. A repository appears again if an agent later sends a review or a session from it.
- Fold a project with the arrow before its name, or every group with Collapse all, beside the filter, which becomes Expand all. Filter the page by a project’s or a repository’s name. Press / to go to the filter.
From a project’s … menu, Open in the inbox shows the reviews of all its repositories, and Open its sessions shows their sessions. A repository’s … menu opens that repository in the inbox, when something waits in it, in the Sessions page or in the history.
Grouping by project
Section titled “Grouping by project”- Inbox: Display options, at the right of the header, groups the waiting reviews by project, by repository, or shows them in one list. Grouped by project, a repository in no project is a group of its own, and in a project with several repositories each review names its repository.
- Sidebar: the button at the right of the sessions heading opens its menu. Under Grouping, choose Project.
- Sessions page: Display options groups the sessions by project, by repository, or shows them in one list.
- Filters: Project or repository, in the Filter menu of the inbox, the history and the Sessions page, lists the projects first. Choosing a project shows the reviews or sessions of all its repositories. Type in it to find a project or a repository by name. In the sidebar, the Project or repository filter of the sessions heading’s menu works the same way, and you can choose several projects and repositories there.
The command palette, ⌘K, has Go to projects, New project…, and Show followed by a project’s name, which opens the inbox filtered to that project.