Skip to content

Commit eafa019

Browse files
authored
Doc updates (#107)
* Ignore all conductor files * Update doc links * Update SPI * Update makefile * Update docs for Swift 6.1
1 parent 1d0d6fe commit eafa019

7 files changed

Lines changed: 16 additions & 16 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,3 +55,4 @@ timeline.xctimeline
5555
xcuserdata
5656
xcuserdata/Package.resolveddocs/
5757
conductor/tracks*
58+
conductor

.spi.yml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
11
version: 1
2-
builder:
3-
configs:
4-
- documentation_targets: [FirebladeECS]
2+
external_links:
3+
documentation: "https://fireblade-engine.github.io/ecs"

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ Please consult the [README][ref-readme] for installation instructions.
8383

8484
[ref-code-of-conduct]: https://github.com/fireblade-engine/ecs/blob/master/CODE_OF_CONDUCT.md
8585
[ref-contributors]: https://github.com/fireblade-engine/ecs/graphs/contributors
86-
[ref-documentation]: https://github.com/fireblade-engine/ecs/wiki
86+
[ref-documentation]: https://fireblade-engine.github.io/ecs
8787
[ref-gh-actions]: https://github.com/fireblade-engine/ecs/actions
8888
[ref-issues-first]: https://github.com/fireblade-engine/ecs/issues?q=is%3Aopen+is%3Aissue+label%3A"good+first+issue"
8989
[ref-issues-help]: https://github.com/fireblade-engine/ecs/issues?q=is%3Aopen+is%3Aissue+label%3A"help+wanted"

Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ preview-analysis-docs:
112112

113113
# Generates documentation pages suitable to push/host on github pages (or another static site)
114114
# Expected location, if set up, would be:
115-
# https://fireblade-engine.github.io/FirebladeECS/documentation/FirebladeECS/
115+
# https://fireblade-engine.github.io/ecs/ -> https://fireblade-engine.github.io/ecs/main/documentation/firebladeecs/
116116
generate-docs-githubpages:
117117
DOCC_JSON_PRETTYPRINT=YES \
118118
swift package \
@@ -122,7 +122,7 @@ generate-docs-githubpages:
122122
--target FirebladeECS \
123123
--output-path ./docs \
124124
--transform-for-static-hosting \
125-
--hosting-base-path 'FirebladeECS'
125+
--hosting-base-path '$(REPO_NAME)'
126126

127127
# --- Workflows ---
128128

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44
[![Linux](https://github.com/fireblade-engine/ecs/actions/workflows/ci-linux.yml/badge.svg)](https://github.com/fireblade-engine/ecs/actions/workflows/ci-linux.yml)
55
[![Windows](https://github.com/fireblade-engine/ecs/actions/workflows/ci-windows.yml/badge.svg)](https://github.com/fireblade-engine/ecs/actions/workflows/ci-windows.yml)
66
[![WASM](https://github.com/fireblade-engine/ecs/actions/workflows/ci-wasm.yml/badge.svg)](https://github.com/fireblade-engine/ecs/actions/workflows/ci-wasm.yml)
7-
[![documentation](https://github.com/fireblade-engine/ecs/workflows/Documentation/badge.svg)](https://github.com/fireblade-engine/ecs/wiki)
7+
[![documentation](https://github.com/fireblade-engine/ecs/workflows/Documentation/badge.svg)](https://fireblade-engine.github.io/ecs)
88
[![codecov](https://codecov.io/gh/fireblade-engine/ecs/branch/master/graph/badge.svg)](https://codecov.io/gh/fireblade-engine/ecs)
99
[![spi-swift-versions](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ffireblade-engine%2Fecs%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/fireblade-engine/ecs)
1010
[![spi-swift-platforms](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ffireblade-engine%2Fecs%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/fireblade-engine/ecs)
1111

1212
This is a **dependency free**, **lightweight**, **fast** and **easy to use** [Entity-Component System](https://en.wikipedia.org/wiki/Entity_component_system) implementation in Swift. It is developed and maintained as part of the [Fireblade Game Engine project](https://github.com/fireblade-engine).
1313

14-
See the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo) or have a look at [documentation in the wiki](https://github.com/fireblade-engine/ecs/wiki) to get started.
14+
See the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo) or have a look at [documentation](https://fireblade-engine.github.io/ecs) to get started.
1515

1616
## 🚀 Getting Started
1717

@@ -25,19 +25,19 @@ These instructions will get you a copy of the project up and running on your loc
2525

2626
### 💻 Installing
2727

28-
Fireblade ECS is available for all platforms that support [Swift 5.8](https://swift.org/) and higher and the [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager).
28+
Fireblade ECS is available for all platforms that support [Swift 6.1](https://swift.org/) and higher and the [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager).
2929

3030
Extend the following lines in your `Package.swift` file or use it to create a new project.
3131

3232
```swift
33-
// swift-tools-version:5.8
33+
// swift-tools-version:6.1
3434

3535
import PackageDescription
3636

3737
let package = Package(
3838
name: "YourPackageName",
3939
dependencies: [
40-
.package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.17.5")
40+
.package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.17.7")
4141
],
4242
targets: [
4343
.target(
@@ -233,7 +233,7 @@ See the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo) t
233233

234234
## 📖 Documentation
235235

236-
Consult the [online documentation](https://swiftpackageindex.com/fireblade-engine/ecs/documentation/FirebladeECS), or preview it locally:
236+
Consult the [online documentation](https://fireblade-engine.github.io/ecs), or preview it locally:
237237

238238
- `make preview-docs`
239239

Sources/FirebladeECS/Documentation.docc/Documentation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Seamlessly, consistently, and asynchronously replicate data.
77
This is a **dependency free**, **lightweight**, **fast** and **easy to use** [Entity-Component System](https://en.wikipedia.org/wiki/Entity_component_system) implementation in Swift.
88
An ECS comprises entities composed from components of data, with systems which operate on the components.
99

10-
Fireblade ECS is available for all platforms that support [Swift 5.8](https://swift.org/) and higher and the [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager).
10+
Fireblade ECS is available for all platforms that support [Swift 6.1](https://swift.org/) and higher and the [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager).
1111
It is developed and maintained as part of the [Fireblade Game Engine project](https://github.com/fireblade-engine).
1212

1313
For a more detailed example of FirebladeECS in action, see the [Fireblade ECS Demo App](https://github.com/fireblade-engine/ecs-demo).

Sources/FirebladeECS/Documentation.docc/GettingStartedWithFirebladeECS.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,14 @@ An ECS comprises entities composed from components of data, with systems which o
1010
Extend the following lines in your `Package.swift` file or use it to create a new project.
1111

1212
```swift
13-
// swift-tools-version:5.8
13+
// swift-tools-version:6.1
1414

1515
import PackageDescription
1616

1717
let package = Package(
1818
name: "YourPackageName",
1919
dependencies: [
20-
.package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.17.5")
20+
.package(url: "https://github.com/fireblade-engine/ecs.git", from: "0.17.7")
2121
],
2222
targets: [
2323
.target(
@@ -33,7 +33,7 @@ For a more detailed example, see the [Fireblade ECS Demo App](https://github.com
3333

3434
### 🏛️ Nexus
3535

36-
The core element in the Fireblade-ECS is the [Nexus](https://en.wiktionary.org/wiki/nexus#Noun).
36+
The core element in the Fireblade ECS is the [Nexus](https://en.wiktionary.org/wiki/nexus#Noun).
3737
It acts as a centralized way to store, access and manage entities and their components.
3838
A single `Nexus` may (theoretically) hold up to 4294967295 `Entities` at a time.
3939
You may use more than one `Nexus` at a time.

0 commit comments

Comments
 (0)