feature: content reuse

content/OpProposerDescriptionShort.md

@@ -0,0 +1 @@
+`op-proposer` is the service that submits the output roots to the L1. This is to enable trustless execution of L2-to-L1 messaging and creates the view into the L2 state from the L1's perspective.

notes/content-reuse.md

@@ -0,0 +1,29 @@
+# Content Reuse
+
+Content reuse is when you reuse the same piece of content in various different places. It means that technical writers don't have to re-write text many times, and it means that the original piece of copy should be easy to locate so that it can be used as often as needed. When changes are made to that original piece of text, it will then be automatically changed wherever else that piece of text is used, which saves a lot of time.
+
+## content directory
+
+The content directory contains markdown files that can be imported across the nextra website.
+
+## how to write reusable content
+
+Create a `.md` file in the `/content` directory.
+
+## how to use resuable content
+
+1. Import it at the top of `.mdx` file:
+
+```
+import DescriptionShort from '@/content/DescriptionShort.md' 
+```
+
+1. Use it within the file
+
+```
+Text before
+
+<OpProposerDescriptionShort />
+
+Text after
+```

pages/builders/chain-operators/architecture.mdx

@@ -6,6 +6,8 @@ description: Learn about the OP chain architecture.
 
 import Image from 'next/image'
 
+import OpProposerDescriptionShort from '@/content/OpProposerDescriptionShort.md' 
+
 # Chain Architecture
 
 This page contains information about the components of the rollup protocol and
@@ -45,9 +47,7 @@ amount of data required to reproduce L2 blocks.
 
 ### op-proposer
 
-`op-proposer` is the service that submits the output roots to the L1. This is to enable
-trustless execution of L2-to-L1 messaging and creates the view into the L2 state from
-the L1's perspective.
+<OpProposerDescriptionShort />
 
 ## Ingress Traffic
 

tsconfig.json

@@ -17,6 +17,7 @@
     "baseUrl": "./",
     "paths": {
       "@/components/*": ["components/*"],
+      "@/content/*": ["content/*"],
       "@/utils/*": ["utils/*"],
       "@/pages/*": ["pages/*"],
     }