Skip to content

Commit a61e751

Browse files
bnasslahsenclaude
andcommitted
ads: move the ad load into the body and cover the unmonetized pages
Side rails, anchors and vignettes are now off in the AdSense console, so the ads that remain are the ones in the content flow. Two changes make up for the lost impressions without crowding the text. faq, modules and core-properties carried no ad unit and did not even load the AdSense script, so the largest page on the site - faq, 97 KB - was earning nothing. Give them in-article slots at section boundaries: three across the FAQ at roughly a quarter, half and four fifths of the way down, two in modules, one in core-properties. The nine copies of the ad markup had already drifted into being one block pasted nine times; fold them into _ad-in-article.adoc so density is a single decision. Add data-ad-frequency-hint=30s to the loader so whatever Auto ads inserts on top of these keeps its distance on long reference pages. v1 stays ad-free. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent e4e0fc4 commit a61e751

55 files changed

Lines changed: 551 additions & 171 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/core-properties.html

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,13 @@
8888
]
8989
}
9090
</script>
91+
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9198
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9299

93100
</head>
@@ -425,6 +432,15 @@ <h1>springdoc-openapi Core Properties Reference</h1>
425432
</tr>
426433
</tbody>
427434
</table>
435+
<ins class="adsbygoogle"
436+
style="display:block; text-align:center; min-height:280px;"
437+
data-ad-layout="in-article"
438+
data-ad-format="fluid"
439+
data-ad-client="ca-pub-8127371937306964"
440+
data-ad-slot="6163211104"></ins>
441+
<script>
442+
(adsbygoogle = window.adsbygoogle || []).push({});
443+
</script>
428444
</div>
429445
</div>
430446
<div class="sect2">
@@ -526,7 +542,7 @@ <h3 id="_springdoc_openapi_mcp_properties"><a class="anchor" href="#_springdoc_o
526542
</div>
527543
<div id="footer">
528544
<div id="footer-text">
529-
Last updated 2026-09-06 16:00:20 +0200
545+
Last updated 2026-09-07 00:17:50 +0200
530546
</div>
531547
</div>
532548
</div>

docs/demos.html

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,12 @@
8989
}
9090
</script>
9191

92-
<!-- Loaded once per page here; the article body only carries the <ins> slots. -->
93-
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous"></script>
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9498
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9599

96100
</head>
@@ -194,7 +198,7 @@ <h3 id="_source_code_of_the_demo_applications"><a class="anchor" href="#_source_
194198
</div>
195199
<div id="footer">
196200
<div id="footer-text">
197-
Last updated 2026-09-06 16:00:20 +0200
201+
Last updated 2026-09-07 00:17:27 +0200
198202
</div>
199203
</div>
200204
</div>

docs/faq.html

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,13 @@
8888
]
8989
}
9090
</script>
91+
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9198
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9299

93100
</head>
@@ -797,6 +804,15 @@ <h3 id="_how_can_i_deploy_springdoc_openapi_starter_webmvc_ui_behind_a_reverse_p
797804
</code></pre>
798805
</div>
799806
</div>
807+
<ins class="adsbygoogle"
808+
style="display:block; text-align:center; min-height:280px;"
809+
data-ad-layout="in-article"
810+
data-ad-format="fluid"
811+
data-ad-client="ca-pub-8127371937306964"
812+
data-ad-slot="6163211104"></ins>
813+
<script>
814+
(adsbygoogle = window.adsbygoogle || []).push({});
815+
</script>
800816
</div>
801817
<div class="sect2">
802818
<h3 id="_is_jsonview_annotations_in_spring_mvc_apis_supported"><a class="anchor" href="#_is_jsonview_annotations_in_spring_mvc_apis_supported"></a>Is <code>@JsonView</code> annotations in Spring MVC APIs supported?</h3>
@@ -1449,6 +1465,15 @@ <h3 id="_how_can_i_build_a_component_schema_from_a_class_programmatically"><a cl
14491465
</li>
14501466
</ul>
14511467
</div>
1468+
<ins class="adsbygoogle"
1469+
style="display:block; text-align:center; min-height:280px;"
1470+
data-ad-layout="in-article"
1471+
data-ad-format="fluid"
1472+
data-ad-client="ca-pub-8127371937306964"
1473+
data-ad-slot="6163211104"></ins>
1474+
<script>
1475+
(adsbygoogle = window.adsbygoogle || []).push({});
1476+
</script>
14521477
</div>
14531478
<div class="sect2">
14541479
<h3 id="_where_can_i_find_the_source_code_of_the_demo_applications"><a class="anchor" href="#_where_can_i_find_the_source_code_of_the_demo_applications"></a>Where can I find the source code of the demo applications?</h3>
@@ -2015,6 +2040,15 @@ <h3 id="_how_can_i_define_different_description_for_a_class_attribute_depending_
20152040
</code></pre>
20162041
</div>
20172042
</div>
2043+
<ins class="adsbygoogle"
2044+
style="display:block; text-align:center; min-height:280px;"
2045+
data-ad-layout="in-article"
2046+
data-ad-format="fluid"
2047+
data-ad-client="ca-pub-8127371937306964"
2048+
data-ad-slot="6163211104"></ins>
2049+
<script>
2050+
(adsbygoogle = window.adsbygoogle || []).push({});
2051+
</script>
20182052
</div>
20192053
<div class="sect2">
20202054
<h3 id="_customizing_swagger_static_resources"><a class="anchor" href="#_customizing_swagger_static_resources"></a>Customizing swagger static resources</h3>
@@ -2308,7 +2342,7 @@ <h3 id="_some_parameters_are_not_generated_in_the_resulting_openapi_spec"><a cla
23082342
</div>
23092343
<div id="footer">
23102344
<div id="footer-text">
2311-
Last updated 2026-09-06 16:00:21 +0200
2345+
Last updated 2026-09-07 00:17:50 +0200
23122346
</div>
23132347
</div>
23142348
</div>

docs/features.html

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,12 @@
8989
}
9090
</script>
9191

92-
<!-- Loaded once per page here; the article body only carries the <ins> slots. -->
93-
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous"></script>
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9498
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9599

96100
</head>
@@ -531,7 +535,7 @@ <h3 id="_integration_with_wildfly"><a class="anchor" href="#_integration_with_wi
531535
</div>
532536
<div id="footer">
533537
<div id="footer-text">
534-
Last updated 2026-08-29 20:55:24 +0200
538+
Last updated 2026-09-07 00:17:27 +0200
535539
</div>
536540
</div>
537541
</div>

docs/getting-started.html

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,12 @@
8989
}
9090
</script>
9191

92-
<!-- Loaded once per page here; the article body only carries the <ins> slots. -->
93-
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous"></script>
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9498
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9599

96100
</head>
@@ -220,7 +224,7 @@ <h3 id="_gradle"><a class="anchor" href="#_gradle"></a>Gradle</h3>
220224
</div>
221225
<div id="footer">
222226
<div id="footer-text">
223-
Last updated 2026-08-29 20:55:24 +0200
227+
Last updated 2026-09-07 00:17:27 +0200
224228
</div>
225229
</div>
226230
</div>

docs/index.html

Lines changed: 60 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,12 @@
7575
}
7676
</script>
7777

78-
<!-- Loaded once per page here; the article body only carries the <ins> slots. -->
79-
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous"></script>
78+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
79+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
80+
long reference page cannot end up with an ad every other paragraph. It only
81+
applies to in-page formats - side rails, anchors and vignettes are switched
82+
off in the AdSense console, not here. -->
83+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
8084
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
8185

8286
</head>
@@ -695,6 +699,15 @@ <h3 id="scalar-support"><a class="anchor" href="#scalar-support"></a>3.5. Scalar
695699
<pre class="highlight"><code class="language-properties" data-lang="properties">server.forward-headers-strategy=framework</code></pre>
696700
</div>
697701
</div>
702+
<ins class="adsbygoogle"
703+
style="display:block; text-align:center; min-height:280px;"
704+
data-ad-layout="in-article"
705+
data-ad-format="fluid"
706+
data-ad-client="ca-pub-8127371937306964"
707+
data-ad-slot="6163211104"></ins>
708+
<script>
709+
(adsbygoogle = window.adsbygoogle || []).push({});
710+
</script>
698711
</div>
699712
<div class="sect2">
700713
<h3 id="mcp-support"><a class="anchor" href="#mcp-support"></a>3.6. MCP support</h3>
@@ -1052,6 +1065,15 @@ <h3 id="spring-cloud-function-web-support"><a class="anchor" href="#spring-cloud
10521065
</li>
10531066
</ul>
10541067
</div>
1068+
<ins class="adsbygoogle"
1069+
style="display:block; text-align:center; min-height:280px;"
1070+
data-ad-layout="in-article"
1071+
data-ad-format="fluid"
1072+
data-ad-client="ca-pub-8127371937306964"
1073+
data-ad-slot="6163211104"></ins>
1074+
<script>
1075+
(adsbygoogle = window.adsbygoogle || []).push({});
1076+
</script>
10551077
</div>
10561078
<div class="sect2">
10571079
<h3 id="kotlin-support"><a class="anchor" href="#kotlin-support"></a>3.12. Kotlin support</h3>
@@ -2496,6 +2518,15 @@ <h3 id="springdoc-openapi-core-properties"><a class="anchor" href="#springdoc-op
24962518
</tr>
24972519
</tbody>
24982520
</table>
2521+
<ins class="adsbygoogle"
2522+
style="display:block; text-align:center; min-height:280px;"
2523+
data-ad-layout="in-article"
2524+
data-ad-format="fluid"
2525+
data-ad-client="ca-pub-8127371937306964"
2526+
data-ad-slot="6163211104"></ins>
2527+
<script>
2528+
(adsbygoogle = window.adsbygoogle || []).push({});
2529+
</script>
24992530
</div>
25002531
<div class="sect2">
25012532
<h3 id="springdoc-openapi-mcp-properties"><a class="anchor" href="#springdoc-openapi-mcp-properties"></a>6.2. springdoc-openapi MCP properties</h3>
@@ -3997,6 +4028,15 @@ <h3 id="how-can-i-deploy-springdoc-openapi-starter-webmvc-ui-behind-a-reverse-pr
39974028
</code></pre>
39984029
</div>
39994030
</div>
4031+
<ins class="adsbygoogle"
4032+
style="display:block; text-align:center; min-height:280px;"
4033+
data-ad-layout="in-article"
4034+
data-ad-format="fluid"
4035+
data-ad-client="ca-pub-8127371937306964"
4036+
data-ad-slot="6163211104"></ins>
4037+
<script>
4038+
(adsbygoogle = window.adsbygoogle || []).push({});
4039+
</script>
40004040
</div>
40014041
<div class="sect2">
40024042
<h3 id="is-jsonview-annotations-in-spring-mvc-apis-supported"><a class="anchor" href="#is-jsonview-annotations-in-spring-mvc-apis-supported"></a>13.25. Is <code>@JsonView</code> annotations in Spring MVC APIs supported?</h3>
@@ -4649,6 +4689,15 @@ <h3 id="how-can-i-build-a-component-schema-from-a-class-programmatically"><a cla
46494689
</li>
46504690
</ul>
46514691
</div>
4692+
<ins class="adsbygoogle"
4693+
style="display:block; text-align:center; min-height:280px;"
4694+
data-ad-layout="in-article"
4695+
data-ad-format="fluid"
4696+
data-ad-client="ca-pub-8127371937306964"
4697+
data-ad-slot="6163211104"></ins>
4698+
<script>
4699+
(adsbygoogle = window.adsbygoogle || []).push({});
4700+
</script>
46524701
</div>
46534702
<div class="sect2">
46544703
<h3 id="where-can-i-find-the-source-code-of-the-demo-applications"><a class="anchor" href="#where-can-i-find-the-source-code-of-the-demo-applications"></a>13.51. Where can I find the source code of the demo applications?</h3>
@@ -5215,6 +5264,15 @@ <h3 id="how-can-i-define-different-description-for-a-class-attribute-depending-o
52155264
</code></pre>
52165265
</div>
52175266
</div>
5267+
<ins class="adsbygoogle"
5268+
style="display:block; text-align:center; min-height:280px;"
5269+
data-ad-layout="in-article"
5270+
data-ad-format="fluid"
5271+
data-ad-client="ca-pub-8127371937306964"
5272+
data-ad-slot="6163211104"></ins>
5273+
<script>
5274+
(adsbygoogle = window.adsbygoogle || []).push({});
5275+
</script>
52185276
</div>
52195277
<div class="sect2">
52205278
<h3 id="customizing-swagger-static-resources"><a class="anchor" href="#customizing-swagger-static-resources"></a>13.77. Customizing swagger static resources</h3>

docs/mcp.html

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,12 @@
8989
}
9090
</script>
9191

92-
<!-- Loaded once per page here; the article body only carries the <ins> slots. -->
93-
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous"></script>
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9498
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9599

96100
</head>
@@ -721,7 +725,7 @@ <h3 id="_schema_conversion"><a class="anchor" href="#_schema_conversion"></a>Sch
721725
</div>
722726
<div id="footer">
723727
<div id="footer-text">
724-
Last updated 2026-09-06 16:00:20 +0200
728+
Last updated 2026-09-07 00:17:27 +0200
725729
</div>
726730
</div>
727731
</div>

docs/modules.html

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,13 @@
8888
]
8989
}
9090
</script>
91+
92+
<!-- Loaded once per page here; the article body only carries the <ins> slots.
93+
The frequency hint spaces out anything Auto ads inserts on top of them, so a
94+
long reference page cannot end up with an ad every other paragraph. It only
95+
applies to in-page formats - side rails, anchors and vignettes are switched
96+
off in the AdSense console, not here. -->
97+
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8127371937306964" crossorigin="anonymous" data-ad-frequency-hint="30s"></script>
9198
<script src="js/setup.js"></script><script defer src="js/site.js"></script>
9299

93100
</head>
@@ -349,6 +356,15 @@ <h3 id="_scalar_support"><a class="anchor" href="#_scalar_support"></a>Scalar su
349356
<pre class="highlight"><code class="language-properties" data-lang="properties">server.forward-headers-strategy=framework</code></pre>
350357
</div>
351358
</div>
359+
<ins class="adsbygoogle"
360+
style="display:block; text-align:center; min-height:280px;"
361+
data-ad-layout="in-article"
362+
data-ad-format="fluid"
363+
data-ad-client="ca-pub-8127371937306964"
364+
data-ad-slot="6163211104"></ins>
365+
<script>
366+
(adsbygoogle = window.adsbygoogle || []).push({});
367+
</script>
352368
</div>
353369
<div class="sect2">
354370
<h3 id="_mcp_support"><a class="anchor" href="#_mcp_support"></a>MCP support</h3>
@@ -706,6 +722,15 @@ <h3 id="_spring_cloud_function_web_support"><a class="anchor" href="#_spring_clo
706722
</li>
707723
</ul>
708724
</div>
725+
<ins class="adsbygoogle"
726+
style="display:block; text-align:center; min-height:280px;"
727+
data-ad-layout="in-article"
728+
data-ad-format="fluid"
729+
data-ad-client="ca-pub-8127371937306964"
730+
data-ad-slot="6163211104"></ins>
731+
<script>
732+
(adsbygoogle = window.adsbygoogle || []).push({});
733+
</script>
709734
</div>
710735
<div class="sect2">
711736
<h3 id="_kotlin_support"><a class="anchor" href="#_kotlin_support"></a>Kotlin support</h3>
@@ -875,7 +900,7 @@ <h3 id="_springdoc_openapi_bom"><a class="anchor" href="#_springdoc_openapi_bom"
875900
</div>
876901
<div id="footer">
877902
<div id="footer-text">
878-
Last updated 2026-09-06 16:00:20 +0200
903+
Last updated 2026-09-07 00:17:50 +0200
879904
</div>
880905
</div>
881906
</div>

0 commit comments

Comments
 (0)