Skip to content

Conversation

@KariraLakshya
Copy link
Contributor

@KariraLakshya KariraLakshya commented Jan 7, 2026

Description

This PR removes bullet points from the onboarding checklist, which previously contained both checkboxes and bullets.

What was changed:

  • Cleaned up the checklist to display only checkboxes
  • Improved visual clarity and consistency of the checklist items

Why this change:

  • Bullet points alongside checkboxes were visually redundant
  • A checkbox-only layout makes the checklist easier to scan and read

No functional behavior was added or modified.

Screenshots

image

Related issue(s)
Fixes #4864

Summary by CodeRabbit

  • Documentation
    • Updated the onboarding checklist to render interactive checkboxes and improved spacing between items for clearer readability and easier task tracking; content and task order remain unchanged.

✏️ Tip: You can customize this high-level summary in your review settings.

@netlify
Copy link

netlify bot commented Jan 7, 2026

Deploy Preview for asyncapi-website ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 55775e0
🔍 Latest deploy log https://app.netlify.com/projects/asyncapi-website/deploys/695f798184ebf20008866746
😎 Deploy Preview https://deploy-preview-4899--asyncapi-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 7, 2026

📝 Walkthrough

Walkthrough

Replaced Markdown checklist items with HTML <input type="checkbox"> elements and added <br /><br /> after each item; textual content and order of tasks remain unchanged. Change is presentation/markup-only; inputs may still render as disabled due to page attributes or styling.

Changes

Cohort / File(s) Summary
Onboarding Checklist Markup Refactor
markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
Replaced Markdown - [ ] checklist items with HTML <input type="checkbox"> elements and preserved labels/links; inserted <br /><br /> after each item for spacing. Presentation/markup-only change; task text unchanged.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I hopped through lines of text so neat,

Swapped brackets for boxes, a tiny feat.
Labels stayed true, the tasks in a row,
A checklist in HTML, ready to show. 🥕

🚥 Pre-merge checks | ✅ 4 | ❌ 1
❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning The PR partially addresses issue #4864 by removing bullet points and displaying checkboxes only, but does not make checkboxes interactive or implement state persistence as outlined in the issue's resolution options. To fully resolve #4864, implement a custom MDX component to make checkboxes interactive with LocalStorage persistence, or confirm that static-only rendering is the intended solution.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: converting the onboarding checklist from Markdown task-list syntax with bullet points to HTML input checkboxes with improved layout.
Out of Scope Changes check ✅ Passed All changes are directly related to improving the onboarding checklist layout as specified in issue #4864; no unrelated modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 50a45a8 and 277ac6a.

📒 Files selected for processing (1)
  • markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
⏰ Context from checks skipped due to timeout of 180000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: cypress-run

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link

codecov bot commented Jan 7, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (28687b1) to head (55775e0).

Additional details and impacted files
@@            Coverage Diff            @@
##            master     #4899   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           22        22           
  Lines          796       796           
  Branches       146       146           
=========================================
  Hits           796       796           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@asyncapi-bot
Copy link
Contributor

asyncapi-bot commented Jan 7, 2026

⚡️ Lighthouse report for the changes in this PR:

Category Score
🔴 Performance 38
🟢 Accessibility 98
🟢 Best practices 92
🟢 SEO 100
🔴 PWA 33

Lighthouse ran on https://deploy-preview-4899--asyncapi-website.netlify.app/

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In @markdown/docs/community/000-onboarding/docs-onboarding-checklist.md:
- Around line 11-22: The checklist has inconsistent spacing: the first item uses
a single <br /> while the remaining items use <br /><br />; update the markup so
all checkbox lines use the same spacing (e.g., change the first item's trailing
<br /> to <br /><br />) by normalizing the repeated <input type="checkbox" ...
/> lines to consistently end with the chosen <br /><br /> sequence so vertical
spacing is uniform across the items.
- Around line 11-22: The first checkbox line uses a single <br /> while the rest
use <br /><br />, causing inconsistent spacing; update the first checkbox line
(the line starting with <input type="checkbox" disabled style={{ transform:
'scale(1.3)', marginRight: '8px' }} /> Read the [AsyncAPI Code of Conduct]...)
to end with <br /><br /> so all checkbox lines consistently use double line
breaks (match the pattern used on subsequent lines).
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7c39172 and 0367f40.

📒 Files selected for processing (1)
  • markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
🧰 Additional context used
🧠 Learnings (1)
📓 Common learnings
Learnt from: akshatnema
Repo: asyncapi/website PR: 3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
⏰ Context from checks skipped due to timeout of 180000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (6)
  • GitHub Check: Redirect rules - asyncapi-website
  • GitHub Check: Header rules - asyncapi-website
  • GitHub Check: Pages changed - asyncapi-website
  • GitHub Check: cypress-run
  • GitHub Check: Lighthouse CI
  • GitHub Check: Test NodeJS PR - windows-latest
🔇 Additional comments (1)
markdown/docs/community/000-onboarding/docs-onboarding-checklist.md (1)

11-22: JSX syntax in inline styles is supported and intentional for this file.

The asyncapi/website repository is configured to process .md files as MDX. The build pipeline in build-pages.ts automatically transforms files from the markdown/ directory (including this file) from .md to .mdx and applies JSX transformations. The next.config.mjs explicitly enables MDX processing with extension: /\.mdx?$/, which matches both file types. The inline style syntax here is valid and fully supported.

Likely an incorrect or invalid review comment.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @markdown/docs/community/000-onboarding/docs-onboarding-checklist.md:
- Line 12: Remove the trailing whitespace characters that appear after the
closing <br /><br /> tag in the checkbox lines (the lines containing the <input
type="checkbox" disabled style={{ transform: 'scale(1.3)', marginRight: '8px' }}
/> Read the [AsyncAPI Slack
etiquette](../060-meetings-and-communication/slack-etiquette).<br /><br />
fragment) and apply the same fix to the other identical checkbox line; ensure
there are no spaces or invisible characters following the final <br /><br />.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0367f40 and 50a45a8.

📒 Files selected for processing (1)
  • markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: akshatnema
Repo: asyncapi/website PR: 3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
📚 Learning: 2024-11-25T18:34:51.303Z
Learnt from: akshatnema
Repo: asyncapi/website PR: 3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.

Applied to files:

  • markdown/docs/community/000-onboarding/docs-onboarding-checklist.md
⏰ Context from checks skipped due to timeout of 180000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: cypress-run
  • GitHub Check: Test NodeJS PR - windows-latest
🔇 Additional comments (1)
markdown/docs/community/000-onboarding/docs-onboarding-checklist.md (1)

11-22: Remove the reference to issue #4864; this PR addresses only spacing inconsistency.

The commit message indicates this PR fixes "Inconsistent line spacing between checklist items," not the UX concern with disabled checkboxes described in your review. Issue #4864 does not exist in the repository. The actual change normalizes <br /><br /> spacing across all 12 checklist items, which appears correctly applied in lines 11-22.

Minor: Remove trailing whitespace on lines 12 and 22 (after <br /><br /> ).

Likely an incorrect or invalid review comment.

@KariraLakshya
Copy link
Contributor Author

@princerajpoot20 I have completed the task in this PR and workflow failed is related to the issue #4853. Otherwise this PR is ready to be reviewed.
Thanks!

@sammy200-ui
Copy link
Contributor

hello @KariraLakshya i want to confirm something about the failing workflow , i dont know if you saw my latest message on that issue or not but i would like to know one thing, can you pls let me know if your forked repo was outdated like behind commits before you raised this pr i will attach a screenshot of where to look if your fork is behind below ? , i will attach you the message that i am referring too

Screenshot 2026-01-08 at 2 59 08 PM

see like it says my branch is 1 commit behind
Screenshot 2026-01-08 at 3 00 06 PM

@KariraLakshya
Copy link
Contributor Author

@sammy200-ui I saw your message regarding the faling workflow but i want to confirm you that before I raised this PR my forked repo was was synced and up to date then also I faced this issue.

@sammy200-ui
Copy link
Contributor

@KariraLakshya hmm...that is weird , now that i am seeing this pr again the workflow is passing now but it was not passing yesterday , i might need to check other prs . Thank you for the response and confirmation !!

@Sourya07
Copy link
Contributor

Sourya07 commented Jan 8, 2026

@KariraLakshya hmm...that is weird , now that i am seeing this pr again the workflow is passing now but it was not passing yesterday , i might need to check other prs . Thank you for the response and confirmation !!

yes it is passing now !!
weird stuff

Copy link
Member

@princerajpoot20 princerajpoot20 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We cannot go ahead with this approach. The reason is that if you view the .md file as a standalone file, it does not look good. So we cannot make changes to the .md file in the way you have done.

Also, just FYI: you cannot make changes to docs under the community section. it is managed from the community repo

@KariraLakshya
Copy link
Contributor Author

KariraLakshya commented Jan 9, 2026

@princerajpoot20 my suggestion was,
Will it be good if we only leave bullet points there and remove checkboxes.
Or should I close the PR??

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DESIGN]: Onboarding Checklist checkboxes are disabled and unclickable

5 participants