mirror of
https://codeberg.org/Codeberg/Documentation.git
synced 2026-08-15 14:53:29 -07:00
Tweaks to welcome users and help getting started (#158)
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**. Co-authored-by: fnetX <git@fralix.ovh> Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/158 Co-authored-by: Otto Richter <fnetx@noreply.codeberg.org> Co-committed-by: Otto Richter <fnetx@noreply.codeberg.org>
This commit is contained in:
parent
e350d2b447
commit
b4537c4ae4
3 changed files with 34 additions and 6 deletions
|
|
@ -7,10 +7,16 @@ eleventyNavigation:
|
|||
---
|
||||
|
||||
## Questions and Issues
|
||||
If you have questions or found any issues with Codeberg, please create an [issue on Codeberg/Community](https://codeberg.org/Codeberg/Community/issues).
|
||||
The most important place to ask for help and report any issues with Codeberg is the [Codeberg/Community issue tracker](https://codeberg.org/Codeberg/Community/issues). It's never wrong to open a ticket there.
|
||||
|
||||
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 (Mastodon / Fediverse will have quicker response times, though).
|
||||
- join the unofficial (community-created) `#codeberg` IRC channel at [libera.chat](https://libera.chat)
|
||||
- use the unofficial (community-created) [Codeberg Subreddit](https://www.reddit.com/r/Codeberg/)
|
||||
|
||||
## Email
|
||||
For direct contact, you can write an email to [contact@codeberg.org](mailto:contact@codeberg.org).
|
||||
|
||||
## Legal inquiries
|
||||
For legal inquiries, please refer to the [Imprint](https://codeberg.org/codeberg/org/src/branch/master/Imprint.md).
|
||||
For legal inquiries, please refer to the [Imprint](https://codeberg.org/codeberg/org/src/branch/master/Imprint.md).
|
||||
|
|
|
|||
|
|
@ -18,12 +18,27 @@ Codeberg is not a corporation but a community of free software enthusiasts provi
|
|||
a humane, non-commercial and privacy-friendly alternative to commercial services
|
||||
such as GitHub.
|
||||
|
||||
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.
|
||||
Beware: The official Gitea instance at [gitea.com](https://gitea.com) is only meant for development of Gitea and related products and not public use!
|
||||
|
||||
People are often asking why they should use Codeberg over other Gitea instances. The most important points Codeberg adds are
|
||||
- a vivid community to collaborate with and ask for help
|
||||
- active maintenance through the community and shared effort to provide an awesome experience
|
||||
- you can take part in operation and decisions, and ideally donate
|
||||
- we add additional services like [Codeberg Pages](/codeberg-pages/) and in the future hosted CI
|
||||
|
||||
## What is Codeberg e.V.?
|
||||
|
||||
Codeberg e.V. is a registered non-profit association based in Berlin, Germany. You don't have to be
|
||||
a member of the association in order to join Codeberg.org or to contribute to the development
|
||||
of the platform, but if you want you can [join Codeberg e.V.](https://join.codeberg.org) to
|
||||
support the project financially, be informed about Codeberg and, optionally, to actively
|
||||
contribute to the association.
|
||||
|
||||
<br>
|
||||
Codeberg members can also take part in the decisions of the platform as explained in the bylaws, and they elect the praesidium and board of the platform, thus Codeberg can be considered as community-owned.
|
||||
|
||||
To start your journey with Codeberg, let's [create an account](/getting-started/first-steps).
|
||||
---
|
||||
|
||||
To start your journey with Codeberg, let's [create an account](/getting-started/first-steps).
|
||||
|
|
|
|||
|
|
@ -1,8 +1,15 @@
|
|||
---
|
||||
permalink: /
|
||||
---
|
||||
Welcome to the Codeberg Documentation pages!
|
||||
Welcome to the Codeberg Documentation pages! We're here to help you when you're having issues or questions with Codeberg.
|
||||
|
||||
Please choose a section from the sidebar on the left, which you can toggle by clicking the three stripes at the top left.
|
||||
|
||||
If you're new to Codeberg, consider reading the [Getting Started Guide](/getting-started).
|
||||
|
||||
## Getting more help
|
||||
|
||||
If you encounter a bug, your question is not answered in the docs or you just can't find it, feel free to open a [Codeberg Community Issue](https://codeberg.org/Codeberg/Community/issues). This is the preferred way to report bugs to the software or ask questions if you can't find an answer somewhere else. You can also quickly find the Codeberg Issues via the dropdown in the navbar.
|
||||
|
||||
There are more [ways to chat with us or the community](/contact/), in pretty much all places are nice people around to help you with your experience.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue