README: Improve Installation/Contributing sections further

(Copy&paste from https://github.com/xmonad/xmonad/pull/340 mostly.)
This commit is contained in:
Tomas Janousek 2021-10-23 00:30:08 +01:00
parent 4560abd1e6
commit 32028915a3

View File

@ -42,35 +42,56 @@ algorithms and extension modules. The two combined make for a powerful X11
window-manager with endless customization possibilities. They are, quite window-manager with endless customization possibilities. They are, quite
literally, libraries for creating your own window manager. literally, libraries for creating your own window manager.
[web:xmonad]: https://xmonad.org/
[gh:xmonad]: https://github.com/xmonad/xmonad
[gh:xmonad-contrib]: https://github.com/xmonad/xmonad-contrib
## Installation ## Installation
For installation and configuration instructions, please see: For installation and configuration instructions, please see:
* [downloading and installing xmonad](https://xmonad.org/download.html) * [downloading and installing xmonad][web:download]
* [installing latest xmonad snapshot from git](https://xmonad.org/INSTALL.html) * [installing latest xmonad snapshot from git][web:install]
* [configuring xmonad](https://xmonad.org/TUTORIAL.html) * [configuring xmonad][web:tutorial]
If you run into any trouble, consult our [documentation][web:documentation] or
ask the [community][web:community] for help.
## Contributing ## Contributing
Haskell code contributed to this repo should live under the We welcome all forms of contributions:
appropriate subdivision of the `XMonad` namespace (currently includes
`Actions`, `Config`, `Hooks`, `Layout`, `Prompt`, and `Util`). For
example, to use the Grid layout, one would import:
XMonad.Layout.Grid * [bug reports and feature ideas][gh:xmonad-contrib:issues]
(also to [xmonad][gh:xmonad:issues])
* [bug fixes, new features, new extensions][gh:xmonad-contrib:pulls]
(also to [xmonad][gh:xmonad:pulls])
* documentation fixes and improvements: [xmonad][gh:xmonad],
[xmonad-contrib][gh:xmonad-contrib], [xmonad-web][gh:xmonad-web]
* helping others in the [community][web:community]
* financial support: [GitHub Sponsors][gh:xmonad:sponsors],
[Open Collective][opencollective:xmonad]
For further details, see the [documentation for the `XMonad.Doc.Developing` Please do read the [CONTRIBUTING][gh:xmonad:contributing] document for more
module][doc:developing], XMonad's [CONTRIBUTING][gh:xmonad:contributing] and information about bug reporting and code contributions. For a brief overview
the [xmonad website][web:xmonad]. of the architecture and code conventions, see the [documentation for the
`XMonad.Doc.Developing` module][doc:developing]. If in doubt, [talk to
[gh:xmonad:contributing]: https://github.com/xmonad/xmonad/blob/master/CONTRIBUTING.md us][web:community].
[doc:developing]: https://xmonad.github.io/xmonad-docs/xmonad-contrib/XMonad-Doc-Developing.html
## License ## License
Code submitted to the xmonad-contrib repo is licensed under the same license Code submitted to the xmonad-contrib repo is licensed under the same license
as xmonad core itself, with copyright held by the authors. as xmonad core itself, with copyright held by the authors.
[doc:developing]: https://xmonad.github.io/xmonad-docs/xmonad-contrib/XMonad-Doc-Developing.html
[gh:xmonad-contrib:issues]: https://github.com/xmonad/xmonad-contrib/issues
[gh:xmonad-contrib:pulls]: https://github.com/xmonad/xmonad-contrib/pulls
[gh:xmonad-contrib]: https://github.com/xmonad/xmonad-contrib
[gh:xmonad-web]: https://github.com/xmonad/xmonad-web
[gh:xmonad:contributing]: https://github.com/xmonad/xmonad/blob/master/CONTRIBUTING.md
[gh:xmonad:issues]: https://github.com/xmonad/xmonad/issues
[gh:xmonad:pulls]: https://github.com/xmonad/xmonad/pulls
[gh:xmonad:sponsors]: https://github.com/sponsors/xmonad
[gh:xmonad]: https://github.com/xmonad/xmonad
[opencollective:xmonad]: https://opencollective.com/xmonad
[web:community]: https://xmonad.org/community.html
[web:documentation]: https://xmonad.org/documentation.html
[web:download]: https://xmonad.org/download.html
[web:install]: https://xmonad.org/INSTALL.html
[web:tutorial]: https://xmonad.org/TUTORIAL.html
[web:xmonad]: https://xmonad.org/