Improving getting started #664

New issue

Open

opened 2025-08-14 17:32:08 +02:00 by urlyman · 2 comments

urlyman commented

2025-08-14 17:32:08 +02:00

I’ve just made my first repo and pushed a commit, but just want to offer the following feedback.

The essence of Your First Steps on Codeberg and the pages it links through to are:

Register and verify email
Create a repo
Make a commit

In my view it doesn’t make prominent enough the need to add an ssh key, verify it, and so on.

Coming from GitHub, and not being proficient at all in command line, I had long since forgotten the need to take those steps, so it took me a while to realise why git push -u origin main was just hanging.

Shouldn’t the ssh key process be more front and centre to ‘first steps’?

I’ve just made my first repo and pushed a commit, but just want to offer the following feedback. The essence of [Your First Steps on Codeberg](https://docs.codeberg.org/getting-started/first-steps/) and the pages it links through to are: 1. Register and verify email 2. Create a repo 3. Make a commit In my view it doesn’t make prominent enough the need to **add an ssh key, verify it**, and so on. Coming from GitHub, and not being proficient at all in command line, I had long since forgotten the need to take those steps, so it took me a while to realise why `git push -u origin main` was just hanging. Shouldn’t the ssh key process be more front and centre to ‘first steps’?

yrljroli commented

2025-08-19 08:32:50 +02:00

When I read Pull requests and Git flow from the link “contribute a pull request” in Your First Steps on Codeberg, I saw “We assume that you have set up your SSH keys.” And there is a link to Adding an SSH key to your account. I think when someone read and following this they will understand it.

When I read [Pull requests and Git flow](https://docs.codeberg.org/collaborating/pull-requests-and-git-flow/) from the link “contribute a pull request” in [Your First Steps on Codeberg](https://docs.codeberg.org/getting-started/first-steps/), I saw “We assume that you have set up your SSH keys.” And there is a link to [Adding an SSH key to your account](https://docs.codeberg.org/security/ssh-key/). I think when someone read and following this they will understand it.

jro commented

2025-08-26 00:20:07 +02:00

(1) The document has a "Word about Security" section. Currently, it talks about multi-factor authentication, but it could be a good place to link to the "How to create an SSH key" section.

(2) Since the title is "First Steps on Codeberg", and creating an SSH key is an important step for SSH-based git, perhaps its worth adding the "Adding an SSH key" to the Moving on From Here section.

In general, I recommend linking into the SSH topics from many areas, because it's quite nested in the settings.

(1) The document has a "Word about Security" section. Currently, it talks about multi-factor authentication, but it could be a good place to link to the "How to create an SSH key" section. (2) Since the title is "First Steps on Codeberg", and creating an SSH key is an important step for SSH-based git, perhaps its worth adding the "Adding an SSH key" to the Moving on From Here section. In general, I recommend linking into the SSH topics from many areas, because it's quite nested in the settings.

No milestone

No project

No assignees

3 participants

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Codeberg/Documentation#664

No description provided.

Rows
Columns