Flatcar documentation analysis by iRaindrop · Pull Request #339 · cncf/techdocs

iRaindrop · 2026-02-27T05:39:15Z

Added template and started customizing

netlify · 2026-02-27T05:39:19Z

✅ Deploy Preview for cncf-techdocs ready!

Name	Link
🔨 Latest commit	`b5d289a`
🔍 Latest deploy log	https://app.netlify.com/projects/cncf-techdocs/deploys/69cc106c6548c000081b1bc3
😎 Deploy Preview	https://deploy-preview-339--cncf-techdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

chalin

The Docsy links have been fixed. Please undo the changes to the pages under docs, and then rebase your PR or to a merge update. (A rebase would be better.) /cc @nate-double-u

* updating domain and netlify information Signed-off-by: Nate W <natew@cncf.io> * Update docs/services.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Nate W <natew@cncf.io> Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

* adding guidance for Series LLCs Signed-off-by: Nate W <natew@cncf.io> * Update docs/website-guidelines-checklist.md Signed-off-by: Nate W <natew@cncf.io> * Update docs/website-guidelines-checklist.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> * updating formatting after applying edit Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Nate W <natew@cncf.io> Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Updating Nate W.'s role. Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

* Revise README, update PC role, add links Signed-off-by: Patrice Chalin <pchalin@gmail.com> * Nate's feedback Signed-off-by: Patrice Chalin <pchalin@gmail.com> --------- Signed-off-by: Patrice Chalin <pchalin@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

* Add Vitess analysis document. Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> * renaming file Signed-off-by: Nate W <natew@cncf.io> * fixing formatting issues Signed-off-by: Nate W <natew@cncf.io> * fixing formatting issues Signed-off-by: Nate W <natew@cncf.io> * Update per review comments, including recommendations for FAQ and troubleshooting. Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> * Update analyses/0014-vitess/analysis.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> * Update analyses/0014-vitess/analysis.md Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io> * removing SEO, Analytics and local search sections as out of scope for this analyis. Signed-off-by: Nate W <natew@cncf.io> * updating spelling wordlist Signed-off-by: Nate W <natew@cncf.io> * fixing format Signed-off-by: Nate W <natew@cncf.io> * removing markdown disable no-bare-urls Signed-off-by: Nate W <natew@cncf.io> * updating codefence formatting Signed-off-by: Nate W <natew@cncf.io> * disabling fence-code-langage check on quoted content Signed-off-by: Nate W <natew@cncf.io> * fixing formatting Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> Signed-off-by: Nate W <natew@cncf.io> Co-authored-by: Nate W <natew@cncf.io> Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

…ncf#312) Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

* adding Daniel to staff list Signed-off-by: Nate W <natew@cncf.io> * formatting and spelling Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

* Chore: Fix all broken links outlined in issue description Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: format files Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: fix markdown error Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: fix markdown error Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: fix markdown error again Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: fix link checker in CI Signed-off-by: thisisobate <obasiuche62@gmail.com> * chore: add backsticks to link Signed-off-by: thisisobate <obasiuche62@gmail.com> --------- Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <12780597+iRaindrop@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Reduce htmltest CacheExpires to ~6 months, update docsy analytics link paths in analytics docs to /docs/content/feedback/#adding-analytics, and refresh static/refcache.json (LastSeen timestamps, some status codes, and a new GitHub ref entry). These changes keep link references current and shorten cache expiry for HTML tests. Signed-off-by: Patrice Chalin Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Signed-off-by: Bruce Hamilton <scarlettbernique@gmail.com>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

…nalysis' into bhamilton-flatcar-analysis

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chalin · 2026-03-31T14:24:41Z

docs/analytics/index.md

+[Adding analytics](https://www.docsy.dev/docs/content/feedback/#adding-analytics)
+[CNCF sandbox]: https://github.com/cncf/sandbox [docsy]: https://www.docsy.dev
+[ga4]: https://support.google.com/analytics/answer/10089681 [service desk]:
+https://github.com/cncf/servicedesk


This Markdown is muddled / broken. Besides, as I had suggested before, there should be no changes under docs. That is, revert the changes to this file. This PR should focus exclusively on the flatcar analysis.

I never had reason to edit index.md and ua-to-ga4.md under docs/analytics, but errors appeared in this PR and I don't know why. Their Markdown is not currently reporting errors now in this PR, so maybe a new PR just to fix them would be good.

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chalin

LGTM in that all checks are passing an no docs pages are being edited via this PR anymore.

@nate-double-u has agreed to do a final review before this gets merged.

analyses/2026/flatcar/analysis.md

chalin · 2026-03-31T16:33:58Z

analyses/2026/flatcar/analysis.md

+| Criterion                  | [Rating (1-5)] |
+| -------------------------- | -------------- |
+| Information architecture   | [rating (1-5)] |
+| New user content           | [rating (1-5)] |
+| Content maintainability    | [rating (1-5)] |
+| Content creation processes | [rating (1-5)] |
+| Inclusive language         | [rating (1-5)] |


Should the ratings be set for each table-entry row?

Yes, still to do - thx

nate-double-u · 2026-03-31T16:56:51Z

Would you like me to clean up the commits @iRaindrop (ie, do a rebase)? You'd likely have to check out the PR again if you're working locally on your machine. Let me know.

Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io>

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

iRaindrop marked this pull request as draft February 27, 2026 05:40

iRaindrop force-pushed the bhamilton-flatcar-analysis branch 2 times, most recently from df99150 to 2545994 Compare March 30, 2026 22:17

chalin requested changes Mar 30, 2026

View reviewed changes

nate-double-u and others added 25 commits March 30, 2026 18:10

Use slack.cncf.io as canonical URL (cncf#300)

5bdf293

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Docusaurus version of docs pages (cncf#301)

4771e4f

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Adjust markdown syntax of analyses pages (cncf#302)

4e04c4d

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Update README.md

fd94c4f

Updating Nate W.'s role. Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Fix licenses (cncf#305)

9dadc76

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Add links to licenses to README and site footer (cncf#306)

2e862c5

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Fix production URL (cncf#308)

0ed9ebf

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

[CI] Use htmltest for link checking (cncf#310)

6448746

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Analytics docs rework: factor out UA-to-GA4 instructions, and more (c…

214fa5c

…ncf#312) Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

adding Daniel to staff list (cncf#316)

142d44e

* adding Daniel to staff list Signed-off-by: Nate W <natew@cncf.io> * formatting and spelling Signed-off-by: Nate W <natew@cncf.io> --------- Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

removing mention of alphabetizing the staff list

e2e9841

Signed-off-by: Nate W <natew@cncf.io> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Update refcache: Add Daniel's GH handle (cncf#319)

b6f41ad

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

[CI] Update packages (cncf#321)

3515b26

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

[docs] Use canonical path in link (cncf#322)

02a5e7b

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Rename {analyses,docs}/**/README.md to index.md (cncf#323)

f313240

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Fix page title, adjust link-check scripts (cncf#324)

ad5cef0

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Link, title, and filename adjustments (cncf#325)

44768a0

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Canonicalize README links, cleanup package.json (cncf#326)

9176192

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Add Knative TechDoc analysis and issues list. (cncf#329)

af88d50

Signed-off-by: Dave Welsch <dwelsch@expertsupport.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chore: fix CI errors

23edd70

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chore: prettify docs

cbb8d42

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

thisisobate and others added 12 commits March 30, 2026 18:39

chore: move info from top level README to docs readme

66e9ead

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chore: fix CI errors

c04c7bc

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chore: nit fix

8941491

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chore: nit fix

ad08ec3

Signed-off-by: thisisobate <obasiuche62@gmail.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Used Prittier extension

6a19e26

Signed-off-by: Bruce Hamilton <12780597+iRaindrop@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

link edits

c999702

Signed-off-by: Bruce Hamilton <12780597+iRaindrop@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

minor edit to rebuild

9d98c0c

Signed-off-by: Bruce Hamilton <12780597+iRaindrop@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

spelling fix

5d4dad4

Signed-off-by: Bruce Hamilton <12780597+iRaindrop@users.noreply.github.com> Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

edit to rebuild

642800e

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Link edits

2375571

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

iRaindrop force-pushed the bhamilton-flatcar-analysis branch from d33f662 to c45e8c9 Compare March 31, 2026 01:44

iRaindrop and others added 6 commits March 30, 2026 18:57

Merge branch 'main' into bhamilton-flatcar-analysis

0e4ca48

Signed-off-by: Bruce Hamilton <scarlettbernique@gmail.com>

Formatting fixes to build

818fbd5

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Merge remote-tracking branch 'refs/remotes/origin/bhamilton-flatcar-a…

f8b78e5

…nalysis' into bhamilton-flatcar-analysis

Minimal formatting fixes

a254030

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Ran VS Code Prittier extension on index.md

a221654

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

minimal format fixes to index.md

376a69c

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

iRaindrop requested a review from chalin March 31, 2026 04:07

chalin requested changes Mar 31, 2026

View reviewed changes

Restore docs/analytics/index.md from upstream/main

9c1d952

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

chalin approved these changes Mar 31, 2026

View reviewed changes

analyses/2026/flatcar/analysis.md Outdated Show resolved Hide resolved

Merge branch 'main' into bhamilton-flatcar-analysis

27904e4

chalin reviewed Mar 31, 2026

View reviewed changes

nate-double-u and others added 4 commits March 31, 2026 09:58

Apply suggestion from @chalin

4780366

Co-authored-by: Patrice Chalin <chalin@users.noreply.github.com> Signed-off-by: Nate W <natew@cncf.io>

put back remaining part of template

93fdf4f

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Fixed prittier hits

88af8e1

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Prittier VS Code ext - Format Document test

b5d289a

Signed-off-by: Bruce Hamilton <bhamilton@expertsupport.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Flatcar documentation analysis#339

Flatcar documentation analysis#339
iRaindrop wants to merge 104 commits intocncf:mainfrom
iRaindrop:bhamilton-flatcar-analysis

iRaindrop commented Feb 27, 2026

Uh oh!

netlify bot commented Feb 27, 2026 •

edited

Loading

Uh oh!

chalin left a comment

Uh oh!

chalin Mar 31, 2026

Uh oh!

iRaindrop Mar 31, 2026

Uh oh!

chalin left a comment

Uh oh!

Uh oh!

chalin Mar 31, 2026

Uh oh!

iRaindrop Mar 31, 2026

Uh oh!

nate-double-u commented Mar 31, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

iRaindrop commented Feb 27, 2026

Uh oh!

netlify bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for cncf-techdocs ready!

Uh oh!

chalin left a comment

Choose a reason for hiding this comment

Uh oh!

chalin Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

iRaindrop Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

chalin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chalin Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

iRaindrop Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

nate-double-u commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

netlify bot commented Feb 27, 2026 •

edited

Loading

nate-double-u commented Mar 31, 2026 •

edited

Loading