guardicore / monkey

Infection Monkey - An open-source adversary emulation platform
https://www.guardicore.com/infectionmonkey/
GNU General Public License v3.0
6.65k stars 780 forks source link

Add server_config.json reference documentation #4216

Open mssalvatore opened 4 months ago

mssalvatore commented 4 months ago

Edit existing documentation 📝

Page to edit

/reference/server-configuration

Required changes

Improve reference documentation for the server_config.json file. Use jsonschema2md to generate markdown documentation for the server_config.json. Note that some elements from the markdown will need to be manually removed (see /reference/payloads/ransomware and /reference/payloads/cryptojacker for an example). You can use the script shown below under "Resources" to dump the plugin's Pydantic options model to JSON. You may need to add details, such as descriptions, to the Pydantic model.

Resources

jsonschema2md Diátaxis

import json
from src.<PLUGIN>_options import <PLUGIN>Options

print(json.dumps(<PLUGIN>Options.model_json_schema(), indent=2))
VakarisZ commented 3 months ago

Related: #4239

shreyamalviya commented 3 months ago

Generating markdown documentation for IslandConfigOptions using jsonschema2md is difficult because of this issue.