From 4ca42d3df1ffa6b241c83eb9abf7d06e5efb6eaa Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 16 Nov 2025 19:13:37 +0000
Subject: [PATCH 1/3] Initial plan


From 83e90301257d2728d45fb263f0b7462351164042 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 16 Nov 2025 19:19:34 +0000
Subject: [PATCH 2/3] Add JSON-LD schemas for BreadcrumbList and TechArticle

Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
---
 _includes/breadcrumb_schema.html  | 41 +++++++++++++++++++++++++++++++
 _includes/head_custom.html        |  4 +++
 _includes/techarticle_schema.html | 36 +++++++++++++++++++++++++++
 3 files changed, 81 insertions(+)
 create mode 100644 _includes/breadcrumb_schema.html
 create mode 100644 _includes/techarticle_schema.html

diff --git a/_includes/breadcrumb_schema.html b/_includes/breadcrumb_schema.html
new file mode 100644
index 00000000..fa451b91
--- /dev/null
+++ b/_includes/breadcrumb_schema.html
@@ -0,0 +1,41 @@
+{% comment %}
+BreadcrumbList JSON-LD Schema.org markup
+Generates breadcrumb navigation structure for SEO
+{% endcomment %}
+{% if page.url != "/" %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}"
+    }
+    {% assign position = 2 %}
+    {% if page.parent %}
+    {% comment %}Find parent page{% endcomment %}
+    {% assign parent_pages = site.pages | where: "title", page.parent %}
+    {% if parent_pages.size > 0 %}
+    {% assign parent = parent_pages | first %}
+    ,{
+      "@type": "ListItem",
+      "position": {{ position }},
+      "name": "{{ parent.title }}",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ parent.url }}"
+    }
+    {% assign position = position | plus: 1 %}
+    {% endif %}
+    {% endif %}
+    ,{
+      "@type": "ListItem",
+      "position": {{ position }},
+      "name": "{{ page.title }}",
+      "item": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}"
+    }
+  ]
+}
+</script>
+{% endif %}
diff --git a/_includes/head_custom.html b/_includes/head_custom.html
index faf36538..98c4b3b0 100644
--- a/_includes/head_custom.html
+++ b/_includes/head_custom.html
@@ -11,3 +11,7 @@
 })(window,document,'script','dataLayer','{{ site.gtm_tracking }}');</script>
 <!-- End Google Tag Manager -->
 {% endif %}
+
+<!-- JSON-LD Schema.org Structured Data -->
+{% include breadcrumb_schema.html %}
+{% include techarticle_schema.html %}
diff --git a/_includes/techarticle_schema.html b/_includes/techarticle_schema.html
new file mode 100644
index 00000000..6828d7b1
--- /dev/null
+++ b/_includes/techarticle_schema.html
@@ -0,0 +1,36 @@
+{% comment %}
+TechArticle JSON-LD Schema.org markup
+Provides structured data for technical documentation pages
+{% endcomment %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "TechArticle",
+  "headline": "{{ page.title | default: site.title }}",
+  {% if page.description %}
+  "description": "{{ page.description | strip_html | strip_newlines | escape }}",
+  {% endif %}
+  "url": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}",
+  {% if page.last_modified_at %}
+  "dateModified": "{{ page.last_modified_at | date_to_xmlschema }}",
+  {% elsif page.date %}
+  "dateModified": "{{ page.date | date_to_xmlschema }}",
+  {% endif %}
+  "author": {
+    "@type": "Organization",
+    "name": "FalkorDB"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "FalkorDB",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "{{ site.url | default: 'https://docs.falkordb.com' }}/images/falkor-logo.png"
+    }
+  },
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}"
+  }
+}
+</script>

From e2343f60c91f21989e6b92a49bded0b169efdf95 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 17 Nov 2025 09:48:59 +0000
Subject: [PATCH 3/3] Add datePublished field to TechArticle schema

Co-authored-by: gkorland <753206+gkorland@users.noreply.github.com>
---
 _includes/techarticle_schema.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/_includes/techarticle_schema.html b/_includes/techarticle_schema.html
index 6828d7b1..79c76c8c 100644
--- a/_includes/techarticle_schema.html
+++ b/_includes/techarticle_schema.html
@@ -11,6 +11,9 @@
   "description": "{{ page.description | strip_html | strip_newlines | escape }}",
   {% endif %}
   "url": "{{ site.url | default: 'https://docs.falkordb.com' }}{{ page.url }}",
+  {% if page.date %}
+  "datePublished": "{{ page.date | date_to_xmlschema }}",
+  {% endif %}
   {% if page.last_modified_at %}
   "dateModified": "{{ page.last_modified_at | date_to_xmlschema }}",
   {% elsif page.date %}