Improve docs (#90)

* Add method

* Remove unnecessary shadowed variable

* Separate pages

docs/.vitepress/config.mts

@@ -2,56 +2,66 @@ import { defineConfig } from 'vitepress'
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
-  title: "Jecs",
-  base: "/jecs/",
-  description: "A VitePress Site",
-  themeConfig: {
-    // https://vitepress.dev/reference/default-theme-config
-    nav: [
-      { text: 'Home', link: '/' },
-      { text: 'Examples', link: '/markdown-examples' }
-    ],
+    title: "Jecs",
+    base: "/jecs/",
+    description: "A VitePress Site",
+    themeConfig: {
+        // https://vitepress.dev/reference/default-theme-config
+        nav: [
+            { text: 'Home', link: '/' },
+            { text: 'Examples', link: '/markdown-examples' },
+            { text: 'API', link: '/api/jecs.md' }
+        ],
 
-    sidebar: [
-      {
-        text: 'Overview',
-        items: [
-          { text: 'Getting Started', link: '/overview/get-started' },
-          { text: 'First Jecs Project', link: '/overview/first-jecs-project' }
-        ]
-      },
-      {
-        text: 'Concepts',
-        items: [
-          { text: 'Entities', link: '/concepts/entities' },
-          { text: 'Static Components', link: '/concepts/static-components' },
-          { text: 'Queries', link: '/concepts/queries' },
-        ]
-      },
-      {
-        text: 'References',
-        items: [
-          { text: 'API Reference', link: '/api' },
-        ]
-      },
-      {
-        text: "FAQ",
-        items: [
-          { text: 'How can I contribute?', link: '/faq/contributing' }
-        ]
-      },
-      {
-        text: 'Contributing',
-        items: [
-          { text: 'Contribution Guidelines', link: '/contributing/guidelines'},
-          { text: 'Submitting Issues', link: '/contributing/issues'},
-          { text: 'Submitting Pull Requests', link: '/contributing/pull-requests'},
-        ]
-      }
-    ],
+        sidebar: {
+            "/api/": [
+                {
+                    text: "API reference",
+                    items: [
+                        { text: "jecs", link: "/api/jecs" },
+                        { text: "World", link: "/api/world" },
+                        { text: "Query", link: "/api/query" }
+                    ]
+                }
+            ],
+            "/learn/": [
+                {
+                    text: "Introduction",
+                    items: [
+                        { text: 'Getting Started', link: '/overview/get-started' },
+                        { text: 'First Jecs Project', link: '/overview/first-jecs-project' }
+                    ]
+                },
+                {
+                    text: 'Concepts',
+                    items: [
+                        { text: 'Entities', link: '/concepts/entities' },
+                        { text: 'Static Components', link: '/concepts/static-components' },
+                        { text: 'Queries', link: '/concepts/queries' },
+                    ]
+                },
+                {
+                    text: "FAQ",
+                    items: [
+                        { text: 'How can I contribute?', link: '/faq/contributing' }
+                    ]
+                },
 
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
-    ]
-  }
+            ],
+            "/contributing/": [
+                {
+                    text: 'Contributing',
+                    items: [
+                        { text: 'Contribution Guidelines', link: '/contributing/guidelines' },
+                        { text: 'Submitting Issues', link: '/contributing/issues' },
+                        { text: 'Submitting Pull Requests', link: '/contributing/pull-requests' },
+                    ]
+                }
+            ]
+        },
+
+        socialLinks: [
+            { icon: 'github', link: 'https://github.com/vuejs/vitepress' }
+        ]
+    }
 })

docs/concepts/queries.md

@@ -1,3 +0,0 @@
-## TODO
-
-This is a TODO stub.

docs/concepts/static-components.md

@@ -1,3 +0,0 @@
-## TODO
-
-This is a TODO stub.

docs/faq/contributing.md

@@ -1,3 +0,0 @@
-## TODO
-
-This is a TODO stub.

docs/learn/concepts/entities.md

@@ -1 +1 @@
-
+

docs/learn/concepts/queries.md

@@ -0,0 +1,3 @@
+## TODO
+
+This is a TODO stub.

docs/learn/concepts/static-components.md

@@ -0,0 +1,3 @@
+## TODO
+
+This is a TODO stub.

docs/learn/faq/contributing.md

@@ -0,0 +1,3 @@
+## TODO
+
+This is a TODO stub.

docs/learn/overview/first-jecs-project.md

@@ -0,0 +1,3 @@
+## TODO
+
+This is a TODO stub.

docs/learn/overview/get-started.md

@@ -1,130 +1,130 @@
-# Getting Started
-
-## Installation
-
-### Installing Standalone
-
-Navigate to the [releases page](https://github.com/Ukendio/jecs/releases) and download `jecs.rbxm` from the assets.
-
-![jecs.rbxm](rbxm.png)
-
-### Using Wally
-
-Add the following to your wally configuration:
-
-::: code-group
-
-```toml [wally.toml]
-jecs = "ukendio/jecs@0.2.3"
-```
-
-:::
-
-### Using npm (roblox-ts)
-
-Use one of the following commands on your root project directory:
-
-::: code-group
-```bash [npm]
-npm i https://github.com/Ukendio/jecs.git
-```
-```bash [yarn]
-yarn add https://github.com/Ukendio/jecs.git
-```
-```bash [pnpm]
-pnpm add https://github.com/Ukendio/jecs.git
-```
-
-:::
-
-## Example Usage
-
-::: code-group
-
-```luau [Luau]
-local world = jecs.World.new()
-local pair = jecs.pair
-local Wildcard = jecs.Wildcard
-
-local Name = world:component()
-
-local function getName(e)
-    return world:get(e, Name)
-end
-
-local Eats = world:component()
-
--- Relationship objects
-local Apples = world:component()
--- components are entities, so you can add components to components
-world:set(Apples, Name, "apples")
-local Oranges = world:component()
-world:set(Oranges, Name, "oranges")
-
-local bob = world:entity()
--- Pairs can be constructed from two entities
-
-world:set(bob, pair(Eats, Apples), 10)
-world:set(bob, pair(Eats, Oranges), 5)
-world:set(bob, Name, "bob")
-
-local alice = world:entity()
-world:set(alice, pair(Eats, Apples), 4)
-world:set(alice, Name, "alice")
-
-for id, amount in world:query(pair(Eats, Wildcard)) do
-    -- get the second target of the pair
-    local food = world:target(id, Eats)
-    print(string.format("%s eats %d %s", getName(id), amount, getName(food)))
-end
-
--- Output:
---   bob eats 10 apples
---   bob eats 5 pears
---   alice eats 4 apples  
-```
-
-
-```ts [Typescript]
-import { Wildcard, pair, World } from "@rbxts/jecs"
-
-
-const world = new World()
-const Name = world.component()
-function getName(e) {
-  return world.get(e, Name)
-}
-
-const Eats = world.component()
-
-// Relationship objects
-const Apples = world.component()
-// components are entities, so you can add components to components
-world.set(Apples, Name, "apples")
-const Oranges = world.component()
-world.set(Oranges, Name, "oranges")
-
-const bob = world.entity()
-// Pairs can be constructed from two entities
-
-world.set(bob, pair(Eats, Apples), 10)
-world.set(bob, pair(Eats, Oranges), 5)
-world.set(bob, Name, "bob")
-
-const alice = world.entity()
-world.set(alice, pair(Eats, Apples), 4)
-world.set(alice, Name, "alice")
-
-for (const [id, amount] of world.query(pair(Eats, Wildcard))) {
-  // get the second target of the pair
-  const food = world:target(id, Eats)
-  print(string.format("%s eats %d %s", getName(id), amount, getName(food)))
-}
-
-// Output:
-//   bob eats 10 apples
-//   bob eats 5 pears
-//   alice eats 4 apples   
-
-```
-
+# Getting Started
+
+## Installation
+
+### Installing Standalone
+
+Navigate to the [releases page](https://github.com/Ukendio/jecs/releases) and download `jecs.rbxm` from the assets.
+
+![jecs.rbxm](rbxm.png)
+
+### Using Wally
+
+Add the following to your wally configuration:
+
+::: code-group
+
+```toml [wally.toml]
+jecs = "ukendio/jecs@0.2.3"
+```
+
+:::
+
+### Using npm (roblox-ts)
+
+Use one of the following commands on your root project directory:
+
+::: code-group
+```bash [npm]
+npm i https://github.com/Ukendio/jecs.git
+```
+```bash [yarn]
+yarn add https://github.com/Ukendio/jecs.git
+```
+```bash [pnpm]
+pnpm add https://github.com/Ukendio/jecs.git
+```
+
+:::
+
+## Example Usage
+
+::: code-group
+
+```luau [Luau]
+local world = jecs.World.new()
+local pair = jecs.pair
+local Wildcard = jecs.Wildcard
+
+local Name = world:component()
+
+local function getName(e)
+    return world:get(e, Name)
+end
+
+local Eats = world:component()
+
+-- Relationship objects
+local Apples = world:component()
+-- components are entities, so you can add components to components
+world:set(Apples, Name, "apples")
+local Oranges = world:component()
+world:set(Oranges, Name, "oranges")
+
+local bob = world:entity()
+-- Pairs can be constructed from two entities
+
+world:set(bob, pair(Eats, Apples), 10)
+world:set(bob, pair(Eats, Oranges), 5)
+world:set(bob, Name, "bob")
+
+local alice = world:entity()
+world:set(alice, pair(Eats, Apples), 4)
+world:set(alice, Name, "alice")
+
+for id, amount in world:query(pair(Eats, Wildcard)) do
+    -- get the second target of the pair
+    local food = world:target(id, Eats)
+    print(string.format("%s eats %d %s", getName(id), amount, getName(food)))
+end
+
+-- Output:
+--   bob eats 10 apples
+--   bob eats 5 pears
+--   alice eats 4 apples  
+```
+
+
+```ts [Typescript]
+import { Wildcard, pair, World } from "@rbxts/jecs"
+
+
+const world = new World()
+const Name = world.component()
+function getName(e) {
+  return world.get(e, Name)
+}
+
+const Eats = world.component()
+
+// Relationship objects
+const Apples = world.component()
+// components are entities, so you can add components to components
+world.set(Apples, Name, "apples")
+const Oranges = world.component()
+world.set(Oranges, Name, "oranges")
+
+const bob = world.entity()
+// Pairs can be constructed from two entities
+
+world.set(bob, pair(Eats, Apples), 10)
+world.set(bob, pair(Eats, Oranges), 5)
+world.set(bob, Name, "bob")
+
+const alice = world.entity()
+world.set(alice, pair(Eats, Apples), 4)
+world.set(alice, Name, "alice")
+
+for (const [id, amount] of world.query(pair(Eats, Wildcard))) {
+  // get the second target of the pair
+  const food = world:target(id, Eats)
+  print(string.format("%s eats %d %s", getName(id), amount, getName(food)))
+}
+
+// Output:
+//   bob eats 10 apples
+//   bob eats 5 pears
+//   alice eats 4 apples   
+
+```
+

docs/overview/first-jecs-project.md

@@ -1,3 +0,0 @@
-## TODO
-
-This is a TODO stub.