Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add initial moonwave documentation #238

Merged
merged 1 commit into from
Dec 30, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
15 changes: 15 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,21 @@
name: Build
on: [push]
jobs:
check-moonwave-docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions-rs/toolchain@v1
with:
toolchain: stable
- uses: actions-rs/cargo@v1
with:
command: install
args: moonwave

- name: Extract moonwave
run: moonwave-extractor extract src

lint:
runs-on: ubuntu-latest
steps:
Expand Down
23 changes: 23 additions & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: Docs
on:
push:
branches:
- main
jobs:
build:
name: Build and deploy docs
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-node@v2
with:
node-version: "14"
- run: npm i -g moonwave@latest
- name: Publish
run: |
git remote set-url origin https://git:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
git config --global user.email "support+actions@github.com"
git config --global user.name "github-actions-bot"
moonwave build --publish
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,5 @@
node_modules
out
roblox.toml
.env
.env
build
2 changes: 1 addition & 1 deletion Nevermore.sublime-project
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
[
{
"path": ".",
"folder_exclude_patterns": [ "node_modules" ]
"folder_exclude_patterns": [ "node_modules", "build" ]
}
]
}
31 changes: 31 additions & 0 deletions docs/intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
sidebar_position: 1
---

# What is Nevermore?

Nevermore is a ModuleScript loader for Roblox, and loads modules by name. Nevermore is designed to make code more portable. Nevermore comes with a variety of utility libraries. These libraries are used on both the client and server and are useful for a variety of things. These libraries are separated into packages that can be consumed individually using npm.

Nevermore follows both functional and OOP programming paradigms. However, many modules return classes, and may require more advance Lua knowledge to use.

# Getting Started with Nevermore

Getting started with Nevermore is not easy.

## Installing Nevermore

1. Install foreman
2. Install npm

## Install using npm
Nevermore is designed to use [npm](https://www.npmjs.com/) to manage packages. You can install a package like this.

```
npm install @quenty/maid
```

Each package is designed to be synced into Roblox using [rojo](https://rojo.space/).

:::warning
Right now you need a special version of Rojo to sync in the npm dependencies properly!
:::
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
--- Makes the character look at nearby physical buttons
-- @classmod LookAtButtonsClient
-- @author Quenty
--[=[
Makes the character look at nearby physical buttons
@class LookAtButtonsClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameBindersClient.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
--- Holds binders
-- @classmod GameBindersClient
-- @author Quenty
--[=[
@class GameBindersClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameServiceClient.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module GameServiceClient
-- @author Quenty
--[=[
@class GameServiceClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameTranslator.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @classmod GameTranslator
-- @author Quenty
--[=[
@class GameTranslator
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
7 changes: 4 additions & 3 deletions games/integration/modules/Server/Button/LookAtButtons.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
--- Makes the character look at nearby physical buttons
-- @classmod LookAtButtons
-- @author Quenty
--[=[
Makes the character look at nearby physical buttons
@class LookAtButtons
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/Button/PhysicalButton.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @classmod PhysicalButton
-- @author Quenty
--[=[
@class PhysicalButton
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/GameBindersServer.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
--- Holds binders
-- @classmod GameBindersServer
-- @author Quenty
--[=[
@class GameBindersServer
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/GameServiceServer.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module GameServiceServer
-- @author Quenty
--[=[
@class GameServiceServer
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module PhysicalButtonConstants
-- @author Quenty
--[=[
@class PhysicalButtonConstants
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
Loading