fix invalid asciidoc in asciidoc reference

Author: adam-cowley

asciidoc/courses/workshop-genai/modules/1-generative-ai/lessons/2-building-the-graph/lesson.adoc

@@ -170,7 +170,8 @@ image::images/8.png[Diagram showing the Neo4j GraphRAG pipeline process from PDF
 
 [.col]
 ====
-```python
+[source, python]
+----
 pipeline = SimpleKGPipeline(
     driver=driver, # Neo4j connection driver
     llm=llm, embedder=embedder,  # OpenAI llm and embeddings
@@ -186,7 +187,7 @@ pdf_documents = [
 # Run the pipeline to transform PDFs into knowledge graph
 for pdf_file in pdf_documents:
     pipeline.run(file_path=pdf_file)
-```
+----
 ====
 
 [.col]

asciidoc/courses/workshop-genai/modules/2-retrievers/lessons/3-hands-on-retrievers/lesson.adoc

@@ -37,55 +37,59 @@ Note how each retriever has its place in a complete GraphRAG system!
 
 All retrievers will use the same LLM and embedder for consistency:
 
-```python
+[source, python]
+----
 from neo4j_graphrag.retrievers import VectorRetriever, VectorCypherRetriever, Text2CypherRetriever
 
 llm = OpenAILLM(model_name="gpt-4o", api_key=OPENAI_API_KEY)
 embedder = OpenAIEmbeddings(api_key=OPENAI_API_KEY)
-```
+----
 
 **Vector Retriever:**
 
 - Returns semantically similar text chunks
 - Good for exploratory questions
 - May miss entity-specific context
 
-```python
+[source, python]
+----
 vector_retriever = VectorRetriever(
     driver=driver,
     index_name="chunkEmbeddings", 
     embedder=embedder
 )
-```
+----
 
 **Vector + Cypher Retriever:**
 
 - Provides both content and relationships
 - Richer context with entity information
 - Better for comprehensive answers
 
-```python
+[source, python]
+----
 vector_cypher_retriever = VectorCypherRetriever(
     driver=driver,
     index_name="chunkEmbeddings",
     retrieval_query=cypher_query,
     embedder=embedder
 )
-```
+----
 
 **Text2Cypher Retriever:**
 
 - Direct, precise answers from graph structure
 - Perfect for factual queries
 - Handles aggregations and counts
 
-```python
+[source, python]
+----
 text2cypher_retriever = Text2CypherRetriever(
     driver=driver,
     llm=llm,
     neo4j_schema=neo4j_schema
 )
-```
+----
 ====
 
 [.slide]
@@ -120,16 +124,19 @@ read::Continue[]
 In this hands-on lesson, you worked with all three retriever types in practice:
 
 **What You Built:**
+
 - Vector Retriever for semantic search
 - Vector + Cypher Retriever for contextual search
 - Text2Cypher Retriever for precise queries
 
 **Key Insights:**
+
 - Different retrievers excel at different question types
 - Combining approaches gives comprehensive coverage
 - Understanding retriever strengths guides selection
 
 **Preparation:**
+
 - You now understand how each retriever works in practice
 - You've seen their different strengths and limitations
 - You're ready to wrap these retrievers as conversational agent tools

docs/asciidoc-elements-reference.adoc

@@ -7,6 +7,7 @@ This document provides a comprehensive reference for all AsciiDoc elements and t
 == Document Header Elements
 
 === Basic Document Header
+
 [source,asciidoc]
 ----
 = Lesson Title
@@ -18,13 +19,15 @@ This document provides a comprehensive reference for all AsciiDoc elements and t
 **Function:** Defines the lesson title and metadata
 
 **Usage:**
+
 - `:type: lesson` - Identifies this as a lesson file
 - `:order: 1` - Sets the lesson order within the module
 - `:slides: true` - Enables slide generation for presentations
 
 == Slide Elements
 
 === Standard Slide
+
 [source,asciidoc]
 ----
 [.slide]
@@ -38,6 +41,7 @@ Content goes here...
 **Usage:** The primary container for slide content in lesson presentations
 
 === Discrete Slide
+
 [source,asciidoc]
 ----
 [.slide.discrete]
@@ -53,6 +57,7 @@ Content without slide numbering...
 === Column Layouts
 
 ==== Two-Column Slide
+
 [source,asciidoc]
 ----
 [.slide.col-2]
@@ -74,6 +79,7 @@ Right column content
 **Usage:** For side-by-side comparisons, diagrams with explanations, or splitting content
 
 ==== Custom Column Ratios
+
 [source,asciidoc]
 ----
 [.slide.col-40-60]
@@ -91,6 +97,7 @@ Content (60% width)
 **Usage:** When you need unequal column widths (40-60, 30-70, etc.)
 
 ==== Discrete Column Slide
+
 [source,asciidoc]
 ----
 [.slide.discrete.col-2]
@@ -106,6 +113,7 @@ Content in columns without slide numbers
 == Content Visibility Elements
 
 === Transcript-Only Content
+
 [source,asciidoc]
 ----
 [.transcript-only]
@@ -125,6 +133,7 @@ not in slide presentations.
 == Navigation Elements
 
 === Continue Button
+
 [source,asciidoc]
 ----
 read::Continue[]
@@ -147,6 +156,7 @@ read::Mark as Completed[]
 == Summary Elements
 
 === Lesson Summary
+
 [source,asciidoc]
 ----
 [.summary]
@@ -169,6 +179,7 @@ In this lesson, you learned:
 == Media Elements
 
 === Images
+
 [source,asciidoc]
 ----
 image::images/diagram.svg[Alt text description, width=80%]
@@ -177,16 +188,19 @@ image::images/diagram.svg[Alt text description, width=80%]
 **Function:** Embeds images with optional sizing and alt text
 
 **Usage:**
+
 - Diagrams and illustrations
 - Screenshots and examples
 - Visual explanations
 
 **Options:**
+
 - `width=80%` - Sets image width as percentage
 - `width=500` - Sets absolute pixel width
 - Alt text in brackets for accessibility
 
 === Videos
+
 [source,asciidoc]
 ----
 video::AhMjmxLPEWM[youtube,width=560,height=315]
@@ -197,6 +211,7 @@ video::AhMjmxLPEWM[youtube,width=560,height=315]
 **Usage:** For demonstration videos, tutorials, or additional explanations
 
 === Includes
+
 [source,asciidoc]
 ----
 include::apple-embedding.adoc[lines=1]
@@ -205,17 +220,20 @@ include::apple-embedding.adoc[lines=1]
 **Function:** Includes content from external files
 
 **Usage:**
+
 - Reusable content blocks
 - Shared examples or data
 - Modular lesson components
 
 **Options:**
+
 - `lines=1` - Include only specific lines
 - `tags=section1` - Include tagged sections
 
 == Layout Helpers
 
 === Column Containers
+
 [source,asciidoc]
 ----
 [.col]
@@ -229,6 +247,7 @@ Column content here
 **Usage:** Must be used inside `.col-2` or similar column slide layouts
 
 === Discrete Styling
+
 [source,asciidoc]
 ----
 [.discrete]
@@ -244,12 +263,15 @@ Column content here
 === Content Organization Guidelines
 
 ==== Avoid Numbered References
+
 **❌ Don't use:**
+
 - "In Lesson 2, we learned..."
 - "From Module 1, you'll remember..."
 - "As we saw in Lesson 3..."
 
 **✅ Use instead:**
+
 - "In the previous lesson, we learned..."
 - "Earlier, you learned..."
 - "As we saw when building the knowledge graph..."
@@ -258,25 +280,29 @@ Column content here
 **Why:** Numbered references create maintenance problems when content gets reorganized, lessons are reordered, or modules are restructured.
 
 === Slide Design
+
 1. **Keep slides concise** - Use bullet points and short phrases
 2. **Use transcript-only for details** - Put lengthy explanations in transcript blocks
 3. **Balance columns** - Ensure column content is roughly equal in length
 4. **Include alt text** - Always provide descriptive alt text for images
 
 === Content Organization
+
 1. **Start with discrete slide** - Use `[.slide.discrete]` for introduction
 2. **End with summary** - Always include a `[.summary]` section
 3. **Add continue button** - Include `read::Continue[]` for navigation
 4. **Use consistent titles** - Follow the same heading structure throughout
 
 === Accessibility
+
 1. **Alt text for images** - Describe what the image shows
 2. **Logical heading hierarchy** - Use proper heading levels (==, ===, etc.)
 3. **Meaningful link text** - Avoid "click here" type links
 
 == Common Patterns
 
 === Standard Lesson Structure
+
 [source,asciidoc]
 ----
 = Lesson Title
@@ -323,6 +349,7 @@ read::Continue[]
 [.col]
 ====
 **Before:**
+
 - Traditional approach
 - Limitations
 - Problems
@@ -331,19 +358,22 @@ read::Continue[]
 [.col]
 ====
 **After:**
+
 - New approach  
 - Benefits
 - Solutions
 ====
 ----
 
 === Hands-On Section
+
 [source,asciidoc]
 ----
 [.slide]
 == Try It Yourself
 
 **Your task:**
+
 1. Step one instruction
 2. Step two instruction
 3. Step three instruction