docs: update usage documentation for new commands

package.json

@@ -155,7 +155,10 @@
     "build": "rimraf lib && node scripts/fetch-asyncapi-example.js && tsc && echo \"Build Completed\"",
     "bump:version": "npm --no-git-tag-version --allow-same-version version $VERSION",
     "dev": "tsc --watch",
-    "generate:assets": "npm run generate:readme:toc",
+    "generate:readme:create": "printf '\n\n# Usage\n\n<!-- usage -->\n\n# Commands\n\n<!-- commands -->\n' > scripts/README.md",
+    "generate:readme:commands": "cd scripts && oclif readme",
+    "generate:assets": "npm run generate:readme:toc && npm run generate:commands",
+    "generate:commands": "npm run generate:readme:create && npm run generate:readme:commands && node ./scripts/updateUsageDocs.js && rimraf ./scripts/README.md",
     "generate:readme:toc": "markdown-toc -i README.md",
     "lint": "eslint --max-warnings 0 --config .eslintrc .",
     "lint:fix": "eslint --max-warnings 5 --config .eslintrc . --fix",

scripts/updateUsageDocs.js

@@ -0,0 +1,26 @@
+const { writeFile, readFile } = require('fs').promises;
+
+// Define the paths to the README and usage files
+const README_PATH = './scripts/README.md'; // File path for the generated README file
+const USAGE_PATH = './docs/usage.md'; 
+
+// Create a header for the usage.md file
+const header = `
+---
+title: 'Usage'
+weight: 40
+---
+
+The AsyncAPI CLI makes it easier to work with AsyncAPI documents.
+`;
+
+// Define an async function to write the header and the README contents to the usage documentation file
+async function run() {
+  await writeFile(USAGE_PATH, header, { encoding: 'utf8' });
+  const readmeContents = await readFile(README_PATH, 'utf8');
+
+  // Append the contents of the README file to the usage documentation file
+  await writeFile(USAGE_PATH, readmeContents, { encoding: 'utf8', flag: 'a' });
+}
+
+run();