From 35275e69114c775eb998b0de2e3be268a482292f Mon Sep 17 00:00:00 2001 From: 2LoS Date: Sat, 30 Aug 2025 10:54:19 +0200 Subject: [PATCH 1/2] Further accessibility improvements --- docs/modules/ROOT/pages/index.adoc | 5 ++--- docs/ui/src/partials/header-content.hbs | 6 +++--- docs/ui/src/partials/nav-explore.hbs | 4 +++- docs/ui/src/partials/nav-menu.hbs | 2 +- docs/ui/src/partials/toolbar.hbs | 7 ++----- 5 files changed, 11 insertions(+), 13 deletions(-) diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index 584fc7ba5b..174b1b38a7 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -6,7 +6,7 @@ Alan Freitas :page-tags: mrdocs :navtitle: Home -image::MrDocsBanner.png[link=https://www.mrdocs.com] +image::MrDocsBanner.png[] - Automating {cpp} reference documentation significantly enhances usability by providing a navigable API and ensuring a single, up-to-date source of truth with minimal effort. - However, documenting {cpp} poses significant challenges due to discrepancies between the codebase and the public API. Doxygen remains a popular tool, yet it is suboptimal for {cpp} as it fails to fully comprehend {cpp} constructs and requires many transformation steps, including the incorporation of many macros within the {cpp} code. These macros maintain well-formed and ill-formed versions of the code, undermining the goal of unifying the source of truth. @@ -14,5 +14,4 @@ image::MrDocsBanner.png[link=https://www.mrdocs.com] - An ideal solution would inherently understand {cpp} constructs, be actively maintained, and offer diverse options for customizing the output format. - Mr.Docs embodies these qualities. Supported by full-time developers from the {cpp} Alliance, Mr.Docs inherently comprehends {cpp} constructs without the need for macros and provides various output formats, customizable templates, and plugin support, ensuring it meets the demands of comprehensive and efficient documentation. -image::https://github.com/cppalliance/mrdocs/actions/workflows/ci.yml/badge.svg[] - +image::https://github.com/cppalliance/mrdocs/actions/workflows/ci.yml/badge.svg[Continuous Integration: Passing] diff --git a/docs/ui/src/partials/header-content.hbs b/docs/ui/src/partials/header-content.hbs index f3a836dc4f..87e57663ee 100644 --- a/docs/ui/src/partials/header-content.hbs +++ b/docs/ui/src/partials/header-content.hbs @@ -1,16 +1,16 @@
From b51a182d5f7d93c59dc0fc94e8d27f387afc72ec Mon Sep 17 00:00:00 2001 From: 2LoS Date: Sat, 30 Aug 2025 11:05:38 +0200 Subject: [PATCH 2/2] Minor adjustments to the homepage --- docs/website/index.html.hbs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/website/index.html.hbs b/docs/website/index.html.hbs index 203909ec3f..c52e6a8e8b 100644 --- a/docs/website/index.html.hbs +++ b/docs/website/index.html.hbs @@ -38,7 +38,7 @@