update docs generation to populate correct docs, remove redundant docs (#1634)

Author: tommaso-moro

cmd/github-mcp-server/generate_docs.go

@@ -36,7 +36,7 @@ func generateAllDocs() error {
 		// File to edit, function to generate its docs
 		{"README.md", generateReadmeDocs},
 		{"docs/remote-server.md", generateRemoteServerDocs},
-		{"docs/deprecated-tool-aliases.md", generateDeprecatedAliasesDocs},
+		{"docs/tool-renaming.md", generateDeprecatedAliasesDocs},
 	} {
 		if err := doc.fn(doc.path); err != nil {
 			return fmt.Errorf("failed to generate docs for %s: %w", doc.path, err)

docs/deprecated-tool-aliases.md

@@ -40,3 +40,11 @@ A user with this configuration:
 ```
 
 Will get `issue_read` and `get_file_contents` tools registered, with no errors.
+
+## Current Deprecations
+
+<!-- START AUTOMATED ALIASES -->
+| Old Name | New Name |
+|----------|----------|
+| *(none currently)* | |
+<!-- END AUTOMATED ALIASES -->