Attention

August 2023 update: osu! Wineskins for macOS, osu!macOS Agent, and this osu!mac documentation website is no longer officially supported or maintained. Official support will no longer be provided by the authors of these respective projects on the osu! forums. You can read more information about this change from Technocoder and aidswidjaja. Thank you for everything.

Contributing

Thank you for your interest in contributing to osu!mac!

osu!mac uses the Sphinx documentation generator, and files are marked up using reStructuredText. We refer to the Python documentation style guide loosely to keep our docs consistent. Docs are hosted on ReadTheDocs.

Note

If you’re interested in contributing to osu!mac’s documentation, there’s no need to write reStructuredText if you’re not so inclined; plain text contributions are more than welcome as well. Please open an issue on GitHub.

Most chatter related to osu!mac should be done by opening an issue on GitHub - forums are not monitored. You can also use the contact details provided here.

Pull requests are welcome at any time, but it’s probably a good idea to make an issue before getting started on it (I might already be working on it!).

Note

When contributing, please ensure to run make html and build the site so that I can work locally as well.

Translations are very welcome but you’ll need to open an issue on GitHub since I have to prepare the docs first on the technical side of things before getting started.

Thank you for helping out!

Tip

See this webpage for informaton about section headings in reStructuredText.