bitburner-src/README.md

42 lines
2.5 KiB
Markdown
Raw Normal View History

2018-03-27 02:46:21 +02:00
# Bitburner
2021-09-05 01:09:30 +02:00
2022-04-14 21:17:46 +02:00
[![Join Discord](https://img.shields.io/discord/415207508303544321)](https://discord.gg/TFc3hKD)
[![Build Status](https://github.com/bitburner-official/bitburner-src/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/bitburner-official/bitburner-src/actions/workflows/ci.yml)
2022-01-04 17:00:04 +01:00
2019-04-20 07:27:33 +02:00
Bitburner is a programming-based [incremental game](https://en.wikipedia.org/wiki/Incremental_game)
that revolves around hacking and cyberpunk themes.
2023-07-31 04:08:36 +02:00
The game can be played at https://bitburner-official.github.io/ (release build), https://bitburner-official.github.io/bitburner-src/ (development build), or installed through [Steam](https://store.steampowered.com/app/1812820/Bitburner/).
2023-01-04 04:17:21 +01:00
The location of the release build may change in the near future.
2022-01-04 17:00:04 +01:00
See the [frequently asked questions](./doc/FAQ.md) for more information . To discuss the game or get help, join the [official Discord server](https://discord.gg/TFc3hKD).
2018-03-27 02:46:21 +02:00
# Documentation
2021-09-05 01:09:30 +02:00
There are 2 types of documentation:
2018-03-27 02:46:21 +02:00
- In-game documentation: It can be found in the Documentation tab. This is the best place to get up-to-date information. You can also read the web version at https://github.com/bitburner-official/bitburner-src/blob/stable/src/Documentation/doc/index.md.
- NS API documentation: It's generated from the [TypeScript definitions](./src/ScriptEditor/NetscriptDefinitions.d.ts). You can read it at https://github.com/bitburner-official/bitburner-src/blob/stable/markdown/bitburner.md.
2018-03-27 02:46:21 +02:00
2018-06-21 16:04:02 +02:00
Anyone is welcome to contribute to the documentation by editing the [source
2024-07-20 02:41:59 +02:00
files](/src/Documentation/doc) and then making a pull request with your contributions.
For further guidance, please refer to the "As A Documenter" section of
2024-07-20 02:41:59 +02:00
[CONTRIBUTING](./doc/CONTRIBUTING.md#as-a-documenter).
2018-03-27 02:46:21 +02:00
2018-06-21 16:04:02 +02:00
# Contribution
2021-09-05 01:09:30 +02:00
2018-06-21 16:04:02 +02:00
There are many ways to contribute to the game. It can be as simple as fixing
a typo, correcting a bug, or improving the UI. For guidance on doing so,
please refer to the [CONTRIBUTING](./doc/CONTRIBUTING.md) document.
2018-03-27 02:46:21 +02:00
You will retain all ownership of the Copyright of any contributions you make,
and will have the same rights to use or license your contributions. By
2018-06-21 16:04:02 +02:00
submitting a pull request you agree to grant me perpetual, worldwide,
non-exclusive, transferable, royalty-free, and irrevocable rights to use,
publish, and distribute your contributions to the project. A formal
Contributor's License Agreement will be drawn up in the future.
2018-03-27 02:46:21 +02:00
If you would like to make significant contributions to the project as a
collaborator, please reach out in #suggestions or #development on Discord to
help coordinate the effort.