Documentation for Satisfactory Mod Loader (SML) and Satisfactory modding. Master branch is live on https://docs.ficsit.app/. Please contact us on the Satisfactory Modding Discord Server with questions and suggestions, or contribute via PRs (see below).
We attempt to use Semantic Line Break format in the source files, but this is only loosely followed.
Pull requests should target the Dev
branch.
Before you submit changes, you should probably follow the Development Setup directions below to verify that the pages are displaying as expected.
Documentation for other mods is also served through the same site. If you have written documentation for your mod and would like it to be added, contact us.
We greatly appreciate any contributions you may have to the docs. Even if you only have the rough outline of a page done, feel free to contact us on the Discord and we'll help you turn it into a full page.
The easiest way to contribute is to make a fork of the repo,
then use a Pull Request targeting the Dev
branch for us to review the changes.
Send us a message on the Discord if we don't review it within a day or two.
If you already have Visual Studio Code and Docker installed, we offer a devcontainer for the repository that will be auto-detected when you open the folder in VSCode.
This should™ also be supported by Github Codespaces, but we haven't tested it.
The container will automatically serve the built content upon opening for preview in your browser or within VSCode.
If you don't want to use the preconfigured devcontainer, or Codespaces, follow the directions below.
Although you can edit the .adoc
files with just about any editor out there,
we suggest either Visual Studio Code (with the
Asciidoc
and Code Spell Checker plugins)
or IntelliJ.
In order to see what the pages will look like on the live site before being deployed, follow the below directions.
-
Install Node.js and Yarn Package Manager through your preferred method
-
Use Yarn to install dependencies
yarn install
To build the docs for SML and all other hosted mods (slow):
yarn run build
To build the docs for just SML, download an alternate Antora playbook file and put it in the root folder of the repo.
Then, run the following:
yarn run build:dev
The output HTML files for both commands can be found in \build\site
.
To preview the content, you can open the output HTML files in your browser, ex. build/site/satisfactory-modding/latest/index.html
You can also run yarn serve
which will start a local webserver.
If you'd like, you can write docs for other mods and have them be included on the live site.
Mods that have done this include FicsIt-Networks, Refined Power, Ficsit Remote Monitoring, TweakIt, and more.
Contact us for more details if you'd like to set this up. The general steps are below:
- Create a repository with your documentation files
- Enable github actions on your repository
- Edit the
antora-playbook-ci.yml
andantora-playbook.yml
files to add your repo as a Source. Follow the format of the other mods already listed there - Make sure you can build this docs repo locally with your site added as a source. Run the
build
task defined inpackage.json
to do this. Consider temporarily commenting out other mods' repos to speed this up. - If you want the deployed copy to automatically update when you push changes to your repo, you should set up an Actions file similar to this one and contact us on the Discord to get a token to add to your secrets so the Actions file can function.
- PR the
Dev
branch with your changes to the playbook files.
We typically create new version branches once a new major or minor version of SML has released. The goal is to provide a point of reference in the docs for working with older versions.
In order to add a new frozen version branch of the docs...
- Create a tag on a commit on the
master
branch following the name formatvX.X.X
, for example,v3.1.1
- Add the tag name to front of the branches list in
antora-playbook.yml
andantora-playbook-ci.yml
, after the HEAD item - You're good to go - CI will take care of deploying it for you.