Tweaks to welcome users and help getting started #158

Merged
fnetX merged 3 commits from fnetX/codeberg-documentation:2021-07-tweaks into master 10 months ago
fnetX commented 10 months ago
Collaborator

In Codeberg/Design#39 the idea was thrown around to put some links
under a new dropdown and prominently link to the docs instead.
This rewrites the docs index page and adds some more information on how
to get started, as well as adds some other tweaks to communication
methods
and gives a new explanation of what Codeberg is.

This PR is my first write-up, rather a dump of three tiny fixes I wanted to do for quite some time now. I didn't set up the generator on this machine yet, so it's not properly tested yet (will do [Update: Done]).

It's not optimal yet IMHO, I still consider it unnecessary to have a docs index page and a getting started page. I think they should be combined somehow.

In Codeberg/Design#39 the idea was thrown around to put some links under a new dropdown and prominently link to the docs instead. This rewrites the docs index page and adds some more information on how to get started, as well as adds some other tweaks to **communication methods** and gives a new explanation of **what Codeberg is**. This PR is my first write-up, rather a dump of three tiny fixes I wanted to do for quite some time now. I didn't set up the generator on this machine yet, so it's not properly tested yet (will do [Update: Done]). It's not optimal yet IMHO, I still consider it unnecessary to have a docs index page and a getting started page. I think they should be combined somehow.
fnetX added the
Status: Ready for Review
Kind: Enhancement
labels 10 months ago
fnetX force-pushed 2021-07-tweaks from acd80a778c to 7587c9e0f7 10 months ago
fnetX added 1 commit 10 months ago
n approved these changes 10 months ago
n left a comment
Collaborator

Looks good! Just some minor suggestions here.

Looks good! Just some minor suggestions here.
If you need quicker help or want to freely discuss topics, or follow up on Codeberg news, you can
- join the [general Codeberg Matrix Channel](https://matrix.to/#/#codeberg.org:matrix.org) (questions, discussions, chat) or the [Codeberg Documentation Matrix Channel](https://matrix.to/#/%23codeberg-documentation%3Amatrix.org) (questions, documentation related discussion)
- follow us on [Mastodon](https://mastodon.technology/@codeberg) or if you aren't on the free and federated social network yet, [on Twitter](https://twitter.com/codeberg_org). You can also send us a direct message (Mastdon / Fediverse will have quicker response times, though).
n commented 10 months ago
Collaborator

Spelling: Mastdon / Fediverse -> Mastodon / Fediverse

Spelling: `Mastdon / Fediverse` -> `Mastodon / Fediverse`
fnetX marked this conversation as resolved
Codeberg e.V. is a registered association based in Berlin, Germany. You don't have to be
## Codeberg vs. Gitea
[Gitea](https://gitea.io) is a free software for Git-based software development that powers Codeberg. Compared to Codeberg, Gitea is not a hosted service, but the free software tool to build those. Everyone can install their own Gitea instance to host their own projects. There are also some Gitea instances next to Codeberg you can use, but please make sure you find a site that is actively maintained and updated, and that you trust the provider. We're looking forward to seeing all those instances federate, so it doesn't matter too much which one you choose.
n commented 10 months ago
Collaborator

We're looking forward to seeing all those instances federate, so it doesn't matter too much which one you choose.

I may be unaware of the progress of Gitea federation, but I think we should drop the second part of the sentence.

> We're looking forward to seeing all those instances federate, so it doesn't matter too much which one you choose. I may be unaware of the progress of Gitea federation, but I think we should drop the second part of the sentence.
Poster
Collaborator

You mean, because this needs to be updated? Hmm, I think it will still take a while, but you might be right.

You mean, because this needs to be updated? Hmm, I think it will still take a while, but you might be right.
fnetX marked this conversation as resolved
fnetX added 1 commit 10 months ago
fnetX merged commit b4537c4ae4 into master 10 months ago

Reviewers

n approved these changes 10 months ago
The pull request has been merged as b4537c4ae4.
Sign in to join this conversation.
No reviewers
No Milestone
No Assignees
2 Participants
Notifications
Due Date

No due date set.

Dependencies

This pull request currently doesn't have any dependencies.

Loading…
There is no content yet.