summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHugo Locurcio <hugo.locurcio@hugo.pro>2020-08-05 17:34:32 +0200
committerHugo Locurcio <hugo.locurcio@hugo.pro>2020-08-10 23:07:34 +0200
commitb0713e9e6c86079670da4b84ef8038e8f6a60b1b (patch)
treea4e2753799d12c06d0734e135a9f5b7230d6c167
parent6831da630f5609e1b659d65425d9da07e25df616 (diff)
Improve the project README
- Use the SVG version of the logo. - Mention console support in the first paragraph. - Point contributors to the `#godotengine-devel` IRC channel. - Improve formatting for better readability. - Add more links when needed. - Fix warnings reported by markdownlint.
-rw-r--r--README.md54
1 files changed, 30 insertions, 24 deletions
diff --git a/README.md b/README.md
index e962f90333..ad0fe3079c 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,29 @@
-[![Godot Engine logo](/logo.png)](https://godotengine.org)
+# Godot Engine
-## Godot Engine
+<p align="center">
+ <a href="https://godotengine.org">
+ <img src="logo.svg" width="400" alt="Godot Engine logo">
+ </a>
+</p>
-Homepage: https://godotengine.org
+## 2D and 3D cross-platform game engine
-#### 2D and 3D cross-platform game engine
+**[Godot Engine](https://godotengine.org) is a feature-packed, cross-platform
+game engine to create 2D and 3D games from a unified interface.** It provides a
+comprehensive set of common tools, so that users can focus on making games
+without having to reinvent the wheel. Games can be exported in one click to a
+number of platforms, including the major desktop platforms (Linux, macOS,
+Windows), mobile platforms (Android, iOS), as well as Web-based platforms
+(HTML5) and
+[consoles](https://docs.godotengine.org/en/latest/tutorials/platform/consoles.html).
-Godot Engine is a feature-packed, cross-platform game engine to create 2D and
-3D games from a unified interface. It provides a comprehensive set of common
-tools, so that users can focus on making games without having to reinvent the
-wheel. Games can be exported in one click to a number of platforms, including
-the major desktop platforms (Linux, Mac OSX, Windows) as well as mobile
-(Android, iOS) and web-based (HTML5) platforms.
-
-#### Free, open source and community-driven
+## Free, open source and community-driven
Godot is completely free and open source under the very permissive MIT license.
No strings attached, no royalties, nothing. The users' games are theirs, down
to the last line of engine code. Godot's development is fully independent and
community-driven, empowering users to help shape their engine to match their
-expectations. It is supported by the Software Freedom Conservancy
+expectations. It is supported by the [Software Freedom Conservancy](https://sfconservancy.org/)
not-for-profit.
Before being open sourced in February 2014, Godot had been developed by Juan
@@ -28,43 +32,45 @@ years as an in-house engine, used to publish several work-for-hire titles.
![Screenshot of a 3D scene in Godot Engine](https://raw.githubusercontent.com/godotengine/godot-design/master/screenshots/editor_tps_demo_1920x1080.jpg)
-### Getting the engine
+## Getting the engine
-#### Binary downloads
+### Binary downloads
Official binaries for the Godot editor and the export templates can be found
[on the homepage](https://godotengine.org/download).
-#### Compiling from source
+### Compiling from source
[See the official docs](https://docs.godotengine.org/en/latest/development/compiling/)
for compilation instructions for every supported platform.
-### Community and contributing
+## Community and contributing
Godot is not only an engine but an ever-growing community of users and engine
developers. The main community channels are listed [on the homepage](https://godotengine.org/community).
-To get in touch with the developers, the best way is to join the
-[#godotengine IRC channel](https://webchat.freenode.net/?channels=godotengine)
+To get in touch with the engine developers, the best way is to join the
+[#godotengine-devel IRC channel](https://webchat.freenode.net/?channels=godotengine-devel)
on Freenode.
To get started contributing to the project, see the [contributing guide](CONTRIBUTING.md).
-### Documentation and demos
+## Documentation and demos
The official documentation is hosted on [ReadTheDocs](https://docs.godotengine.org).
It is maintained by the Godot community in its own [GitHub repository](https://github.com/godotengine/godot-docs).
The [class reference](https://docs.godotengine.org/en/latest/classes/)
-is also accessible from within the engine.
+is also accessible from the Godot editor.
The official demos are maintained in their own [GitHub repository](https://github.com/godotengine/godot-demo-projects)
as well.
-There are also a number of other learning resources provided by the community,
-such as text and video tutorials, demos, etc. Consult the [community channels](https://godotengine.org/community)
-for more info.
+There are also a number of other
+[learning resources](https://docs.godotengine.org/en/latest/community/tutorials.html)
+provided by the community, such as text and video tutorials, demos, etc.
+Consult the [community channels](https://godotengine.org/community)
+for more information.
[![Actions Build Status](https://github.com/godotengine/godot/workflows/Godot/badge.svg?branch=master)](https://github.com/godotengine/godot/actions)
[![Code Triagers Badge](https://www.codetriage.com/godotengine/godot/badges/users.svg)](https://www.codetriage.com/godotengine/godot)