docs(contract): improve the content of the index.md file used as TOC …

…for NatSpec docs

website/src/scripts/setupSolidityDocs.ts

@@ -70,6 +70,12 @@ function generateMarkdownLinks(dir, relativePath = ""): string {
 // copy over the directory
 copyDirectory(sourceDir, solidityDocDir);
 // generate index.md content
-const content = "# Solidity NatSpec Documentation\n\n" + generateMarkdownLinks(solidityDocDir, "solidity-docs");
+let content = "# Solidity NatSpec Documentation\n\nThis directory provides autogenerated ";
+content += "documentation for the [MACI v1.x smart contracts](/docs/contracts/) and interfaces ";
+content += "based on the [NatSpec Format](https://docs.soliditylang.org/en/latest/natspec-format.html) ";
+content += "for Solidity contracts.\n\n## MACI contracts and interfaces\n";
+content += "[TOC of contracts, linking to pages]\n\n";
+content += generateMarkdownLinks(solidityDocDir, "solidity-docs");
+
 // save the content to index.md
 fileS.writeFileSync(pathX.join(solidityDocDir, "index.md"), content, "utf8");