From 5d05e5ae5dab54d3489523cd14de9d86ddb02a23 Mon Sep 17 00:00:00 2001
From: Ukendio <ukendio@gmail.com>
Date: Wed, 31 Jul 2024 04:16:28 +0200
Subject: [PATCH] Get Help

---
 docs/learn/overview/first-jecs-project.md | 72 ++++++++++++++++++++++-
 1 file changed, 70 insertions(+), 2 deletions(-)

diff --git a/docs/learn/overview/first-jecs-project.md b/docs/learn/overview/first-jecs-project.md
index 1346d9f..8006935 100644
--- a/docs/learn/overview/first-jecs-project.md
+++ b/docs/learn/overview/first-jecs-project.md
@@ -1,3 +1,71 @@
-## TODO
+# First Jecs project
 
-This is a TODO stub.
\ No newline at end of file
+Now that you have installed Jecs, you can create your [World](world.md).
+
+:::code-group
+```luau [luau]
+local jecs = require(path/to/jecs)
+local world = jecs.World.new()
+```
+```typescript [typescript]
+import { World } from "@rbxts/jecs"
+const world = new World()
+```
+:::
+
+Let's create a couple components.
+
+:::code-group
+```luau [luau]
+local jecs = require(path/to/jecs)
+local world = jecs.World.new()
+
+local Position = world:component()
+local Velocity = world:component()
+```
+
+```typescript [typescript]
+import { World } from "@rbxts/jecs"
+const world = new World()
+
+const Position = world.component()
+const Velocity = world.component()
+```
+:::
+
+Systems can be as simple as a query in a function or a more contextualized construct. Let's make a system that moves an entity and decelerates over time.
+
+:::code-group
+```luau [luau]
+local jecs = require(path/to/jecs)
+local world = jecs.World.new()
+
+local Position = world:component()
+local Velocity = world:component()
+
+for id, position, velocity in world:query(Position, Velocity) do
+    world:set(id, Position, position += velocity)
+    world:set(id, Velocity, velocity * 0.9)
+end
+```
+
+```typescript [typescript]
+import { World } from "@rbxts/jecs"
+const world = new World()
+
+const Position = world.component()
+const Velocity = world.component()
+
+for (const [id, position, velocity] of world.query(Position, Velocity)) {
+    world.set(id, Position, position.add(velocity)
+    world.set(id, Velocity, velocity.mul(0.9))
+}
+```
+:::
+
+## Where To Get Help
+
+If you are encounting problems, there are resources for you to get help:
+- [Roblox OSS Discord server](https://discord.gg/h2NV8PqhAD) has a [#jecs](https://discord.com/channels/385151591524597761/1248734074940559511) thread under the [#projects](https://discord.com/channels/385151591524597761/1019724676265676930) channel
+- [Open an issue](https://github.com/ukendio/jecs/issues) if you run into bugs or have feature requests
+- Dive into the nitty gritty in the [thesis paper](https://raw.githubusercontent.com/Ukendio/jecs/main/thesis/drafts/1/paper.pdf)