From bc8060dee4355667680dab8935a7abd504ceefbd 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 07a744814855a8bcb8d196c6c31f9bde7cfcf249) (cherry picked from commit a7fe270c08c25e6db42c32019b4a1a0720a57ec1) (cherry picked from commit 2f15389a9cafa00001c84396a1a88a14c3250e5c) (cherry picked from commit 16ba587f5dbbfa36398ca55e5210e5233211e224) (cherry picked from commit 683a23b2ca29f3638a2bd703dad567ae2896f261) (cherry picked from commit 3e5de3f656fa769317bf1cd1e508682f89e90000) (cherry picked from commit 5789005c4355f9d6b76a2288376b3b45a7939ba0) (cherry picked from commit 75c0f11079bc1e376b55186c4994bea71a54cd15) (cherry picked from commit e78a272e111066950ad5a365e504e1aacb4de5b7) (cherry picked from commit 464a534a3a712111b5578523bb657cd36cb10f64) (cherry picked from commit 7c0b73ca6fc28696fd580d7f858f8d814436e9a6) (cherry picked from commit e66b8edbc6fa1120ea4e66d586ea46c06a865a05) (cherry picked from commit a91864340d75d16e6afce18e7e5b974cfae8719f) (cherry picked from commit 504905bc882ad075f821fb4fcd86560191bdada9) (cherry picked from commit 650137433f44d65570947c8dbad6fb51b18f8a68) (cherry picked from commit 3e00bdaf2a2d47d168108cd130829d6d864fa4b4) (cherry picked from commit 43efcc1a29449c802b18a09387af67c24e71b189) (cherry picked from commit 4984ba13c57fdade1a5744713c98a60e650a5b9a) (cherry picked from commit 02b7928710ad9446b93598801dff0afae828136a) (cherry picked from commit 0db0feaee25187bcd4c28c9e66d3d0eabaad7a8d) (cherry picked from commit 94d141bc7f488ab0e6512218cac409b63cf83700) (cherry picked from commit 392fb1589178338b8285df7b348754e79611590e) (cherry picked from commit c5699a7bb71962321b131c9ac4413f8710de0d56) (cherry picked from commit b975597a781c745463d9db80a220733d99a12e28) (cherry picked from commit 5395e74d72285490f25067c8ac72899a3e23f3e7) --- README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000000..e223979d42 --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +
+ +

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. + +## Learn more + +Dive into the [documentation](https://forgejo.org/docs/latest/), 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).