A Krunker documentation website that purely focuses on KrunkScript (no editor/monetization).
- Unmerging/Merging docs so you can use CTRL + F, like the old documentation.
- More up to date.
- Removes flaws from the original documentation.
- Important notes for developers, that quickly show important information, like rate limits or deprecation.
- Clearer & less text, removed bloaty examples.
- Cosistent formatting across the website.
- Prefilled action parameters, allowing you to instantly paste and test code.
- Quick access to frequently used stuff, like the entire player object or a list of all hooks.
- An extension to directly integrate the documentation into the editor.
Contribution tutorial: https://youtu.be/8gDw0qeV78Y
Showcase video: https://youtu.be/HVjUv2oDxxA
- First pull this project, and create a new branch based on master to work on.
- Make your changes, use
yarn dev
to serve the site. On windows, you'll have to re-serve the website for it to update (vuepress issue sadly :/). - When happy with your changes, make sure they match our style guidelines.
- Then push them onto a branch so it can be merged with master.
It is not mandatory to stick to this style guideline, it just saves me some time while reviewing the PR's. It's best to just follow along the lines of what this doc does. Keep in mind tho: practicality is king.
# Category title (should always be present)
## Topic
### Subtopic
A topic must start with the Tags: section, if tags are available. If a word is already mentioned, it does not need to be repeated in tags. Keep tags to a minimum.
**Tags: skybox**
Then a description follows. A description starts with capital letters and ends with a period. It shortly describes what the topic is and what it is used for. Descriptions are not needed if the topic is self explanatory (for example: "Moving, rotating & scaling objects")\
Skydomes are a group of settings that allow you to change the atmosphere of your level in certain areas.
Lastly, a code sample. Every "action/command" in a codeblock is desired to be commented, unless stating something obvious or making documentation hard to read. There should be a space between a bracket and the comment, comments should start with a captical letter and end without a period. Easy wording is more important than technical/official terminology. This documentation is practicality first, it's even more important then these styling guidelines.
```krunkscript
# Remove skydome
GAME.SCENE.removeSkyDome();
'``
One of SOTT Quick krunker docs' main advantages is that you can directly copy a prefilled function and test it yourself. For this, there is a specific formatting.
- Parameters need to be prefilled
- Comment on the same line, starting with the type and then a description of what it does.
- End with a ;
GAME.action(
"parameter value" # str example
);
Images and videos are almost always welcome. I am actively looking to add more and more direct examples to this documentation.