work in a repository
Work in a repository
Repositories, changes and tasks.
On this page
Repositories
A repository is a real git repository, private to you. There are no collaborators, organisations or public repositories. Make one in Push your code.
| Tab | Shows |
|---|---|
| Code | Files at a branch, a tag or a commit |
| Changes | Proposals to merge one branch into another |
| Tasks | Work you have written down |
| Runs | Checks of this repository's commits |
| History | Commits, newest first. Branches and Tags sit under it |
| Where | What |
|---|---|
| Code | File actions: Copy path, Copy contents, Permalink. Permalink fixes the file at its commit. The commit line above a file is the branch's latest, not the file's last change. |
| History | 50 commits a page. Empty: No commits yet. |
| Branches | The default branch comes first. Behind · ahead compares a branch with it. Change links the open change. |
| Tags | Empty: Push one with git push origin <tag>. |
| Clone menu | Copies the clone command or address. An empty repository also shows Quick setup. |
| On the page | You cannot delete a branch or create a tag. Use git. |
Changes
A change proposes merging branch From
into branch Into
. Opening one merges nothing.
- On the Changes tab press New change. Choose
Into
(the default branch to start) andFrom
. - Press
Compare
, write a title, add a Markdown description if you like, then press Open change.
| Message | What to do |
|---|---|
| A change needs two branches. | Push another branch with git. |
| Pick two different branches. A branch has nothing to propose to itself. | Choose different branches. |
| Change #N already proposes X for Y. | Open that change instead. |
| Topic | Detail |
|---|---|
| States | Open, Closed, Merged. Changes and tasks share one number sequence. |
| Review | Comments only: the Commentbox on Overview, or a line on Files. There is no approve. |
| Close | Close changekeeps the branch. Reopen changeworks while both branches exist. |
| Merge methods | Create a merge commit, Squash and merge, Fast-forward, as git allows for the pair. |
| Merge | A box asks you to confirm. If a branch moved, nothing merges. Conflicts are listed: fix them on your machine and push. |
| Check | An open change with no run on its head commit offers Check properties. See Check your code. |
Watch out
A merge cannot be undone from Ruhub.
Tasks
A task is work you want done. It is private to you, with no assignee, and you can write one before any code exists.
- On the Tasks tab press New task. Write the
Title
(required) and, if you like, theDescription
.Markdown. Optional.
- Tick any
Labels
, then pressOpen task
.
| Topic | Detail |
|---|---|
| New labels | Type a name in the task's label box. Names ignore letter case. |
Link a commit by sha | Type seven or more characters of the sha. Type more if several commits match. |
| Close | Close as completed, Close as not planned; later Reopen. |
| States | Open, Closed · completed, Closed · not planned |
Checked against Ruhub on .
