Skip to content

Commit d0908ce

Browse files
committed
Add readme
1 parent e1f1ae4 commit d0908ce

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

README.MD

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# faf-java-commons
2+
3+
A library of shared code for the FAForever java projects:
4+
* [FAF API](https://github.com/FAForever/faf-java-api)
5+
* [FAF client](https://github.com/FAForever/downlords-faf-client)
6+
* [FAF moderator client](https://github.com/FAForever/faf-moderator-client)
7+
8+
## Modules
9+
10+
This repository contains 3 standalone modules:
11+
12+
* **API** contains code to interact with the FAF API
13+
* **Lobby** contains code to interact with the FAF Lobby server.
14+
* **Data** contains code to interact with FAF and SupCom file formats in general.
15+
16+
## Versioning and compatibility
17+
18+
This project does **not** follow semantic versioning. The published packages follow a `<YYMMDD>-<git commit hash>`
19+
pattern to always suggest the latest version.
20+
21+
There might be breaking changes. We always enforce compatibility to the most recent API.
22+
23+
This project does **not** ensure backwards compatibility for 3rd party applications. Use at your own
24+
risk.
25+
26+
27+
## Releasing
28+
29+
The project is released on [maven central](https://mvnrepository.com/artifact/com.faforever.commons).
30+
31+
It also can be released on Jitpack but with its special Jitpack group id. We no longer ensure a working Jitpack release.
32+
33+
**Maintainer info:**
34+
To release a new version, trigger the `Publish package to MavenCentral` Github action. Afterwards it needs to be
35+
published on [Sonatype](https://central.sonatype.com/publishing/namespaces) with the FAForever user. It always takes
36+
some time to show up afterwards.

0 commit comments

Comments
 (0)