diff --git a/docs/spec/index.html b/docs/spec/index.html
index 471d35e10..c665e62e8 100644
--- a/docs/spec/index.html
+++ b/docs/spec/index.html
@@ -443,6 +443,15 @@ <h2>Interoperability Testing</h2>
       roles (`issuer`, `holder`, and `verifier`), in turn invoking the
       participating platform.
     </p>
+    <h3>Implementation guidelines</h3>
+    <p>
+      This specification aims at demonstrating technical implementation between participating parties in the context of traceability.
+      For broader interoperability testing or for implementers looking for a way to get started managing verifiable credentials, please refer
+      to the <a href="https://w3c-ccg.github.io/vc-api/">VC-API specification</a> when starting to design your software. 
+      The VC-API group maintains an extensive set of test-suites for other technical aspects not covered by this specification, 
+      such as issuance, did resolving, verification and status updates. They also provide extensive guidance for new participants.
+      It is recommended to implement the vc-api prior to joining this group, unless you are experienced in Verifiable Credentials.
+    </p>
   </section>
 
   <section class="informative">
@@ -475,27 +484,6 @@ <h2>OAS Implementation</h2>
                 clientCredentials:
                   tokenUrl: https://conformant-platform.example.com/oauth/token
     </pre>
-    <h3>Code Generation</h3>
-    <p>
-      The <a href=""><code>openapi-typescript-codegen</code></a> project provides
-      a means for generating typescript clients based on OpenAPI specifications.
-    </p>
-    <pre class="example">
-      # Install openapi-typescript-codegen globally
-      npm install -g openapi-typescript-codegen
-
-      # Produce a dereferenced openapi specification JSON file from this repo.
-      npm run preserve
-
-      # Generate a typescript client from the dereferenced openapi specification JSON file.
-      npx openapi-typescript-codegen --input ./docs/openapi/openapi.json
-    </pre>
-    <p>
-      Please refer to the `openapi-typescript-codegen` project page for more detailed
-      <a href="https://github.com/ferdikoomen/openapi-typescript-codegen/tree/master#install">installation</a>
-      and <a href="https://github.com/ferdikoomen/openapi-typescript-codegen/tree/master#usage">usage</a>
-      instructions.
-    </p>
   </section>
 
   <section class="normative">