docs: custom domain + HTML/CSS linting + fast, universal, modern site#45
Merged
Conversation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Runs HTMLHint via npx on every push/PR that touches docs/. No new action required — uses pre-installed Node on ubuntu-latest with actions/checkout only. Rules: doctype, title, attr casing, tag pairs, unique IDs, non-empty src, alt required. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- HTML: html5validator (W3C vnu.jar wrapper) — official W3C HTML5 validator - CSS: Stylelint with stylelint-config-standard — industry standard CSS linter - Drop HTMLHint and .htmlhintrc - alpha-value-notation: number and color-function-notation: legacy to match the existing rgba()/opacity number style in styles.css Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Restructure CSS to satisfy no-descending-specificity: move generic typography (a, ul, li) before layout components; interleave toc and sidebar-nav link rules ordered by specificity (0,1,1 → 0,2,1 → 0,2,2) - Convert all rgba() to modern rgb(r g b / a) notation; remove color-function-notation: legacy override from .stylelintrc.json - Lowercase font stack names (blinkmacsystemfont, helvetica, arial, consolas) - Replace -webkit-text-size-adjust with text-size-adjust - Expand all single-line multi-declaration blocks - Remove duplicate width: 100% (kept calc(100% - 40px)) - Rename BEM double-dash classes to single-dash in CSS and all HTML files: callout--tip/warning/note/summary → callout-tip/warning/note/summary btn--primary/secondary → btn-primary/secondary - Update media queries to range notation: max-width: N → width <= N - Replace deprecated page-break-* with break-* (break-inside, break-after) - Remove redundant .site-footer a rule (covered by generic a rule) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Update workflow count from 8 to 9 - Add HTML & CSS Lint section (html-lint.yml): W3C Nu Checker + Stylelint, path-filtered to docs/**, no new action allowlist entries needed - Fix PSScriptAnalyzer description: SARIF is serialised inline via ConvertTo-Json, no ConvertToSARIF module or PSGallery dependency - Fix Trivy trigger: now Push/PR/weekly (pull_request was added) - Add Docs quality row to Security Scanning Stack Summary table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Speed: - Drop Google Fonts (preconnect x2 + render-blocking stylesheet) on all 8 pages in favour of a zero-network system-ui font stack - Load Mermaid CDN only on the 3 pages that render diagrams (overview, configuration, architecture); removed from the other 5 Universal (no browser-specific CSS): - Replace ::-webkit-scrollbar with standard scrollbar-width/scrollbar-color - Remove -webkit-overflow-scrolling and text-rendering hacks Modern / UX: - Unify accent on blue (drop AI-purple #533483); update Mermaid theme vars - Expo easing token cubic-bezier(.16,1,.3,1) via --ease/--transition - Fluid type with clamp(); text-wrap balance/pretty on headings/paragraphs - :active press feedback on buttons, hamburger, theme toggle, copy button - Card hover lift; stronger table row hover Accessibility: - :focus-visible outlines for keyboard nav - prefers-reduced-motion: reduce disables smooth scroll + transitions - color-scheme set per theme for native form/scrollbar theming - @media (hover: none) keeps copy button visible on touch - Larger 44px touch target on hamburger Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
EliorMachlev
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Started as the GitHub Pages custom-domain change and grew into a full docs-site hardening + overhaul. Everything here is scoped to
docs/, the docs CI, and the README badge — no application/service code is touched.What's included
1. Custom domain
docs/CNAME→JenkinsAsService.machlev.org(DNS already configured)2. Docs quality gate (new CI)
html-lint.yml: W3C Nu HTML Checker + Stylelint (stylelint-config-standard), path-filtered todocs/**, no new SHA-pinned actions requiredosv-scanner.yml(Trivy): addpull_requesttrigger so the check runs on PRs<ul>wrapped in<li>)rgb(), kebab-case classes, range media queries,break-*, selector-specificity ordering, etc.)3. Performance — super fast
overview,configuration,architecture); removed from the other 5 — the landing page now ships no third-party JS4. Universal — no browser-specific CSS
::-webkit-scrollbar→ standardscrollbar-width/scrollbar-color-webkit-overflow-scrollingandtext-renderinghacks-webkit-/-moz-/-ms-remain indocs/5. Modern + accessible
#533483), incl. Mermaid theme varscubic-bezier(.16,1,.3,1); fluidclamp()type;text-wrapbalance/pretty:activepress feedback, card hover-lift, stronger table-row hover:focus-visibleoutlines,prefers-reduced-motion,color-schemeper theme,@media (hover: none)keeps the Copy button usable on touch, 44px hamburger targetVerification
🤖 Generated with Claude Code