]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - README.md
Fix a bunch of really obvious unnecessary includes.
[user/henk/code/inspircd.git] / README.md
index 89524e7e7b52343af09f581b5922ac40bb09fcd2..553d41332eaf6fb25dc54a3abfa6fbc4e0d59f92 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,28 +1,44 @@
-### Important Notice
+## About
 
-The `master` branch contains the latest development version. If you are running
-a server then you probably want the `insp20` branch. You can obtain this from
-the [releases](https://github.com/inspircd/inspircd/releases) page or by running
-`git checkout insp20` if you are installing via Git.
+InspIRCd is a modular C++ Internet Relay Chat (IRC) server for UNIX-like and Windows systems.
 
-### About
+## Supported Platforms
 
-InspIRCd is a modular Internet Relay Chat (IRC) server written in C++ for Linux,
-BSD, Windows and Mac OS X systems which was created from scratch to be stable,
-modern and lightweight.
+InspIRCd is supported on the following platforms:
 
-As InspIRCd is one of the few IRC servers written from scratch, it avoids a
-number of design flaws and performance issues that plague other more established
-projects, such as UnrealIRCd, while providing the same level of feature parity.
+- Most recent BSD variants using the Clang or GCC compilers and the GNU toolchains (Make, etc).
 
-InspIRCd is one of only a few IRC servers to provide a tunable number of
-features through the use of an advanced but well documented module system. By
-keeping core functionality to a minimum we hope to increase the stability,
-security and speed of InspIRCd while also making it customisable to the needs of
-many different users.
+- Most recent Linux distributions using the Clang or GCC compilers and the GNU toolchain.
 
-### Links
+- The most recent three major releases of macOS using the AppleClang, Clang, or GCC (*not* LLVM-GCC) compilers and the GNU toolchains.
 
-* [Website](http://inspircd.org)
+- Windows 7 or newer using the MSVC 14 (Visual Studio 2015) compiler and CMake 2.8 or newer.
+
+Alternate platforms and toolchains may also work but are not officially supported by the InspIRCd team. Generally speaking if you are using a reasonably modern UNIX-like system you should be able to build InspIRCd on it.
+
+If you encounter any bugs then [please file an issue](https://github.com/inspircd/inspircd/issues/new/choose).
+
+## Installation
+
+Most InspIRCd users running a UNIX-like system build from source. A guide about how to do this is available on [the InspIRCd docs site](https://docs.inspircd.org/3/installation/source).
+
+Building from source on Windows is generally not recommended but [a guide is available](https://github.com/inspircd/inspircd/blob/master/win/README.txt) if you wish to do this.
+
+If you are running on CentOS 7, Debian 7, or Windows binary packages are available from [the downloads page](https://github.com/inspircd/inspircd/releases/latest).
+
+A [Docker](https://www.docker.com) image is also available. See [the inspircd-docker repository](https://github.com/inspircd/inspircd-docker) for more information.
+
+Some distributions ship an InspIRCd package in their package managers. We generally do not recommend the use of such packages as in the past distributions have made broken modifications to InspIRCd and not kept their packages up to date with essential security updates.
+
+## License
+
+InspIRCd is licensed under [version 2 of the GNU General Public License](https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html).
+
+## External Links
+
+* [Website](https://www.inspircd.org)
+* [Documentation](https://docs.inspircd.org)
 * [GitHub](https://github.com/inspircd)
-* [IRC](irc://irc.chatspike.net/inspircd)
\ No newline at end of file
+* [Support IRC channel](https://kiwiirc.com/nextclient/irc.inspircd.org:+6697/inspircd?nick=Your%20nick%20here) — \#inspircd on irc.inspircd.org
+* [Development IRC channel](https://kiwiirc.com/nextclient/irc.inspircd.org:+6697/inspircd.dev?nick=Your%20nick%20here) — \#inspircd.dev on irc.inspircd.org
+* [InspIRCd test network](https://kiwiirc.com/nextclient/testnet.inspircd.org:+6697/?nick=Your%20nick%20here) — testnet.inspircd.org