Code Example Patterns — code example pattern library
doc-writer agent technical document includedto do code example quality pattern.
5stage example structure
1. goal — " code X perform"
2. companybefore condition — library, environment number, setting
3. core code — minimum work example
4. execution result — expected capability
5. extension point — "next stage Y to do number "
example vs example
** example** ( None):
result = client.process(data)
** example** (specialistbasisquality):
# pip install example-sdk
from example_sdk import Client
client = Client(api_key="your-api-key")
data = {"name": "test", "value": 42}
result = client.process(data)
print(result.status) # "success"
by style guide
Python
- order: tablelevel → from →
- type included (3.10+)
- docstring: Google style (Args, Returns, Raises)
- f-string usage, format degree
TypeScript
- ESM import usage (require degree)
- async/await usage (Promise degree)
- person/type specify
- try/catch error processing
cURL
- ()as readability secure
- environmentnumber information minute
- expected annotationas included
code composition pattern
pattern 1: pointquality building (Progressive Build)
Step 1: minimum work code
Step 2: input processing addition
Step 3: error processing addition
Step 4: setting external
Step 5: code
each stagefrom **change departmentminute only **, existing code ...as approx..
pattern 2: problem-
#### problem: [specific problem description]
#### : [code and method]
pattern 3: comparison
| method | advantage | disadvantage | code |
|---|---|---|---|
| basis | result = fetch |
||
| basis | nature | result = await fetch |
code annotation rule
| rule | description |
|---|---|
| WHY annotation | "" writingdegree |
| WHAT prohibited | "" code specialist |
| Korean annotation | Korean documentfrom Korean |
| TODO prohibited | example un-nature prohibited |
| description | "actual environmentfrom..." annotation |
information processing
# : environmentnumber
api_key = os.environ["API_KEY"]
# document placeholder
api_key = "your-api-key-here" # actual
quality checklist
| item | standard |
|---|---|
| specialistbasisnature | import~executionto company-basis work |
| error processing | try/catch included |
| type information | number/un-/exchange type specify |
| execution result | expected capability included |
| information | when None |
| version specify | /library version |