Update readme (#172)
* Readme: link to docs repository * Move compile and release instructions to new file * Remove compile and release instructions from readme
This commit is contained in:
parent
45baa626bc
commit
12023c4d5c
44
CONTRIBUTING.md
Normal file
44
CONTRIBUTING.md
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
## Compiling
|
||||||
|
|
||||||
|
The traditional route is by undergoing the [AO2 Rite of Passage](https://gist.github.com/oldmud0/6c645bd1667370c3e92686f7d0642c38).
|
||||||
|
|
||||||
|
However, these days it is easy to get away with using the default Qt toolchain on any platform, which creates a dynamic executable. (Don't forget to invoke windeployqt when creating a release.)
|
||||||
|
|
||||||
|
### Dependencies
|
||||||
|
|
||||||
|
- [BASS](http://un4seen.com) (optional; may use Qt Multimedia instead)
|
||||||
|
- [Discord Rich Presence](https://github.com/discordapp/discord-rpc) (optional)
|
||||||
|
|
||||||
|
## Release instructions
|
||||||
|
|
||||||
|
Follow these steps to make a new full release:
|
||||||
|
|
||||||
|
- Set a new AO version in the `.pro` file and in `aoapplication.h`.
|
||||||
|
- Compile the project.
|
||||||
|
- Commit the version bump and and create a tag for the commit.
|
||||||
|
- Rename the executable to `Attorney_Online`.
|
||||||
|
- Create a temp directory.
|
||||||
|
- Copy a fresh `base` folder to the temp dir. Ensure that the timestamps are consistent.
|
||||||
|
- Ignore this step if creating a client-only release.
|
||||||
|
- Copy the repository's `base` folder to the temp dir.
|
||||||
|
- Append `.sample` to the names of all `.ini` files, including `serverlist.txt`.
|
||||||
|
- Copy the game executable to the temp dir.
|
||||||
|
- Copy `bass.dll`, `discord-rpc.dll`, and `qapng.dll` if applicable.
|
||||||
|
- Copy `README.md` as `README.md.txt` with CRLF line endings.
|
||||||
|
- Copy `LICENSE` as `LICENSE.txt` with CRLF line endings.
|
||||||
|
- Compress the contents of the temp dir to an archive with maximum compression, but
|
||||||
|
be sure that the contents are placed inside the root directory of the archive and not
|
||||||
|
within a subdirectory.
|
||||||
|
- Compute the SHA-1 hash of the archive.
|
||||||
|
- Upload the archive to the Wasabi bucket and an additional mirror (e.g. MEGA or OneDrive)
|
||||||
|
(if this is a full release).
|
||||||
|
- Publish a GitHub release and upload the archive there (if this is a client-only release).
|
||||||
|
- Add the new version to the `program.json` manifest for the respective platform
|
||||||
|
(if this is a client-only release).
|
||||||
|
- Update the following on the website for the respective platform:
|
||||||
|
- Full download links (Wasabi and mirror)
|
||||||
|
- Client download link
|
||||||
|
- Full download hash
|
||||||
|
- Client download hash
|
||||||
|
|
||||||
|
Repeat for each platform (currently 32-bit Windows and 64-bit Linux). Once you're done, don't forget to announce your release!
|
47
README.md
47
README.md
@ -2,52 +2,7 @@
|
|||||||
|
|
||||||
[Attorney Online](https://aceattorneyonline.com) is an online version of the world-renowned courtroom drama simulator that allows you to create and play out cases in an off-the-cuff format.
|
[Attorney Online](https://aceattorneyonline.com) is an online version of the world-renowned courtroom drama simulator that allows you to create and play out cases in an off-the-cuff format.
|
||||||
|
|
||||||
## [Refer to the Wiki](https://github.com/Crystalwarrior/KFO-Client/wiki) for more information.
|
**[Refer to the docs](https://github.com/AttorneyOnline/docs/blob/master/docs/index.md) for more information.**
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Compiling
|
|
||||||
|
|
||||||
The traditional route is by undergoing the [AO2 Rite of Passage](https://gist.github.com/oldmud0/6c645bd1667370c3e92686f7d0642c38). Recently, however, it has become more feasible to get away with a dynamic compilation, which is much easier for beginners and requires less setup.
|
|
||||||
|
|
||||||
### Dependencies
|
|
||||||
|
|
||||||
- [BASS](http://un4seen.com) (proprietary, but will become optional in the future; see #35)
|
|
||||||
- [Discord Rich Presence](https://github.com/discordapp/discord-rpc)
|
|
||||||
|
|
||||||
## Release instructions
|
|
||||||
|
|
||||||
Follow these steps to make a new full release:
|
|
||||||
|
|
||||||
- Set a new AO version in the `.pro` file and in `aoapplication.h`.
|
|
||||||
- Compile the project.
|
|
||||||
- Commit the version bump and and create a tag for the commit.
|
|
||||||
- Rename the executable to `Attorney_Online`.
|
|
||||||
- Create a temp directory.
|
|
||||||
- Copy a fresh `base` folder to the temp dir. Ensure that the timestamps are consistent.
|
|
||||||
- Ignore this step if creating a client-only release.
|
|
||||||
- Copy the repository's `base` folder to the temp dir.
|
|
||||||
- Append `.sample` to the names of all `.ini` files, including `serverlist.txt`.
|
|
||||||
- Copy the game executable to the temp dir.
|
|
||||||
- Copy `bass.dll`, `discord-rpc.dll`, and `qapng.dll` if applicable.
|
|
||||||
- Copy `README.md` as `README.md.txt` with CRLF line endings.
|
|
||||||
- Copy `LICENSE` as `LICENSE.txt` with CRLF line endings.
|
|
||||||
- Compress the contents of the temp dir to an archive with maximum compression, but
|
|
||||||
be sure that the contents are placed inside the root directory of the archive and not
|
|
||||||
within a subdirectory.
|
|
||||||
- Compute the SHA-1 hash of the archive.
|
|
||||||
- Upload the archive to the Wasabi bucket and an additional mirror (e.g. MEGA or OneDrive)
|
|
||||||
(if this is a full release).
|
|
||||||
- Publish a GitHub release and upload the archive there (if this is a client-only release).
|
|
||||||
- Add the new version to the `program.json` manifest for the respective platform
|
|
||||||
(if this is a client-only release).
|
|
||||||
- Update the following on the website for the respective platform:
|
|
||||||
- Full download links (Wasabi and mirror)
|
|
||||||
- Client download link
|
|
||||||
- Full download hash
|
|
||||||
- Client download hash
|
|
||||||
|
|
||||||
Repeat for each platform (currently 32-bit Windows and 64-bit Linux). Once you're done, don't forget to announce your release!
|
|
||||||
|
|
||||||
## Credits
|
## Credits
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user