diff --git a/Tool-tasks.md b/Tool-tasks.md index 9affe71..9376e83 100644 --- a/Tool-tasks.md +++ b/Tool-tasks.md @@ -2,19 +2,31 @@ _Tool tasks_ are tasks that can be run from the AuthMe codebase for various purp Once you start the ToolsRunner, a list of all available tools will be displayed. After entering the tool name the corresponding tool will be run. -### Available tasks -Name | Description ----- | ----------------------------- -- addJavaDocToMessageEnum | -- checkTestMocks | -- createCommandPage | -- describeHashAlgos | -- drawDependencyGraph | -- generateCommandsYml | -- generatePluginYml | -- updateConfigPage | -- updateDocs | -- updateTranslations | -- verifyHelpTranslations | -- verifyMessages | -- writePermissionsList | \ No newline at end of file +_Tool tasks_ are tasks that can be run from the AuthMe codebase for various purposes, e.g. to generate docs pages or to verify messages tasks. All tool tasks are started from the same runner, the ToolsRunner, located test/tools/ToolsRunner.java. Tip: you can save the run configuration for the ToolsRunner so that you can always easily run a tool task. + +Once you start the ToolsRunner, a list of all available tools will be displayed. After entering the tool name the corresponding tool will be run. + +## Available tasks +Cat | Name | Description +------------ | ----------------------- | ----------- +:paperclip: | addJavaDocToMessageEnum | Adds a JavaDoc comment to each MessageKey entry with the according English message. +:paperclip: | checkTestMocks | Checks that test classes' `@Mock` fields correspond to the tested class' `@Inject` fields. +:green_book: | createCommandPage | Updates the docs/commands.md page. +:green_book: | describeHashAlgos | Updates the docs/hash_algorithms.md page. +:paperclip: | drawDependencyGraph | Generates AuthMe's dependency graph as .dot file - requires GraphWiz to render. +:pencil2: | generateCommandsYml | Creates the commands.yml config file with default data. +:pencil2: | generatePluginYml | Generates the plugin.yml with up-to-date command and permission info. +:green_book: | updateConfigPage | Updates the docs/config.md page. +:green_book: | updateDocs | Updates all files in the docs/ folder. +:green_book: | updateTranslations | Updates the docs/translations.md page. +:flashlight: | verifyHelpTranslations | Verifies all or a specific help translation file in resources/messages. +:flashlight: | verifyMessages | Verifies all or a specific messages file in resources/messages. +:green_book: | writePermissionsList | Updates the docs/permission_nodes.md page. + +### Categories +Icon | Category +------------ | -------- +:green_book: | Docs/ page generation +:flashlight: | Verification task +:pencil2: | Project file udpate +:paperclip: | Technical task \ No newline at end of file