diff --git a/DOCS.md b/DOCS.md
index 285a581..dda2f6e 100644
--- a/DOCS.md
+++ b/DOCS.md
@@ -57,15 +57,14 @@ You can `import` other `.tsp` files.
 
 For now, we're assuming you write everything in typelex. You can grab common Lexicons from the [Playground](https://playground.typelex.org/). However, if you just want a ref, you could stub out any external Lexicon, like this:
 
-```
-/** Some docstring */
+```typescript
 namespace com.example.defs {
   subject: com.atproto.repo.strongRef.Main; // OK to use here
 }
 
-// This is a stub
+// This is a stub!
 namespace com.atproto.repo.strongRef {
-  model Main { }
+  model Main { } // It's fine to leave this empty
 }
 ```