aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLoïc Dachary2022-12-17 14:06:57 +0100
committerLoïc Dachary2023-03-12 15:17:09 +0100
commit07a744814855a8bcb8d196c6c31f9bde7cfcf249 (patch)
tree1cfe4315caeeb3500ad9c25a8caeae3d1d17d8c0
parent9a66b3d70b6e7d2a3ee146d3708d48d8f9bfe305 (diff)
[DOCS] README
(cherry picked from commit a47b4745861ba2ab7485974d27334aed44feeac3) (cherry picked from commit 2fcc61c1d929380884dd9aeb143c202a2be0eef9) (cherry picked from commit 67debe2247c83753173efba53c60845f522857b5) (cherry picked from commit b90ffbb309bc76968588a024d2ced081989295ea)
-rw-r--r--README.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..d61bdd0ec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+<div align="center">
+ <img src="https://codeberg.org/forgejo/meta/raw/branch/readme/logo/forgejo.svg" alt="" width="192" align="center" />
+ <h1 align="center">Welcome to Forgejo</h1>
+</div>
+
+Hi there! Tired of big platforms playing monopoly?
+Providing Git hosting for your project, friends, company or community?
+**Forgejo** (/for'd&#865;ʒe.jo/ inspired by forĝejo – the Esperanto word for *forge*) has you covered with its intuitive interface,
+light and easy hosting and a lot of builtin functionality.
+
+Forgejo was [created in 2022](https://forgejo.org/2022-12-15-hello-forgejo/)
+because we think that the project should be owned by an independent community.
+If you second that, then Forgejo is for you!
+Our promise: **Independent Free/Libre Software forever!**
+
+## What does Forgejo offer?
+
+<!-- If you want to know what Forgejo is like,
+you can check out public instances,
+e.g. [Codeberg.org](https://codeberg.org).
+-->
+
+If you like any of the following, Forgejo is literally meant for you:
+
+- Lightweight: Forgejo can easily be hosted on nearly **every machine**.
+ Running on a Raspberry? Small cloud instance? No problem!
+- Project management: Besides Git hosting, Forgejo offers issues,
+ pull requests, wikis, kanban boards and much more to **coordinate with your team**.
+- Publishing: Have something to share? Use **releases** to host your software for download,
+ or use the **package registry** to publish it for docker, npm and many other package managers.
+- Customizable: Want to change your look? Change some settings?
+ There are many **config switches** to make Forgejo work exactly like you want.
+- Powerful: Organizations & team permissions, CI integration, Code Search, LDAP, OAuth and much more.
+ If you have **advanced needs**, Forgejo has you covered.
+- Privacy: From update checker to default settings: Forgejo is built to be **privacy first** for you and your crew.
+- Federation: (WIP) We are actively working to connect software forges with each other through **ActivityPub**,
+ and create a collaborative network of personal instances.
+ Interested? [Read more](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/CONTRIBUTING/WORKFLOW.md#federation-https-codeberg-org-forgejo-forgejo-issues-labels-79349)
+
+## Learn more
+
+Subscribe to releases and blog post on [our website](https://forgejo.org), <a href="https://floss.social/@forgejo" rel="me">find us on the Fediverse</a> or hop into [our Matrix room](https://matrix.to/#/#forgejo-chat:matrix.org) if you have any questions or want to get involved.
+
+
+## Get involved
+
+If you are interested in making Forgejo better, either by reporting a bug or by changing the governance, please [take a look at the contribution guide](CONTRIBUTING.md).