Docs site: ad density on documentation pages is hurting readability
Author: brianckeeganCreated Jun 15, 2026Updated Jun 15, 2026
Labelstriage
Contact Details
No response
What do you need?
I want to flag a UX concern with the advertising on particles.js.org. On the guide, options, and API pages especially, the volume and placement of AdSense units is heavy enough that it competes with the actual documentation: pushing content down, fragmenting code snippets, and causing layout shift as ads load. On smaller viewports it's particularly rough, where ad blocks can take up more of the fold than the reference material I came to read.
Please tune the reading experience so ads support the docs rather than crowd them out. A few options that other dev-doc projects use to balance both:
- Reduce the number of in-content slots per page, or move them out of the main reading column (sidebar/footer rather than mid-article).
- Avoid injecting ads between or inside code blocks, since that's where it most breaks the workflow.
- Reserve fixed slot heights to eliminate cumulative layout shift as ads load.
- Consider a developer-friendly network like EthicalAds (used by Read the Docs and others) — typically one unobtrusive, privacy-respecting unit per page.
- Optionally, keep the reference/API pages lighter than the marketing/landing pages.
Happy to help test or give feedback on any changes. Thanks again for the project.
tsParticles Version
4.1.3
Code of Conduct
- I agree to follow this project's Code of Conduct
Source: tsparticles/tsparticles