From d4e031cdabba19443f62b813b0de81c4797a669e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Dachary?= Date: Sat, 17 Dec 2022 14:06:57 +0100 Subject: [PATCH] [DOCS] README (cherry picked from commit a47b4745861ba2ab7485974d27334aed44feeac3) (cherry picked from commit 2fcc61c1d929380884dd9aeb143c202a2be0eef9) (cherry picked from commit 67debe2247c83753173efba53c60845f522857b5) (cherry picked from commit b90ffbb309bc76968588a024d2ced081989295ea) (cherry picked from commit 2af3b8d476f511abbe589c5350554ebabe98925b) (cherry picked from commit a469c07cc3b73f440272458c7dae7ac5287b0747) (cherry picked from commit 10f848d6d92265219ac8a1ee1184a4da250f6e93) (cherry picked from commit 1a364f5585ce5e5ea9eb5f98feabe60d1a1d7c07) --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000000..d61bdd0ec9 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +
+ +

Welcome to Forgejo

+
+ +Hi there! Tired of big platforms playing monopoly? +Providing Git hosting for your project, friends, company or community? +**Forgejo** (/for'd͡ʒ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 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), find us on the Fediverse 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).