Need help from community: validate a beginner-first CKB developer onboarding guide

English CKB Development & Technical Discussion
1

Hi everyone,

I have been working on a beginner-first CKB developer onboarding guide. The goal is to provide a short and reproducible path from zero setup to the first successful public RPC response, followed by optional local node and indexer checks.

The guide has already been validated on macOS arm64. I am now looking for community help for validation on Windows and Linux, as well as feedback from developers who are new to CKB.

I created small, focused github issues so contributors can choose a task that matches their operating system and available time. Some tasks only require running a single RPC command and reporting the result. Opening a pull request is not required; a comment with test results is already useful. I will update the guide in that case with the provided test data.

The most useful areas right now are:

  • Windows PowerShell validation;

  • Windows Git Bash validation;

  • Linux Bash validation;

  • Beginner review of the Quick Start guide;

  • Technical review of RPC, local node, and indexer instructions.

Repository:

Open validation tasks:

Any feedback, reproduction results, documentation corrections, or suggestions are welcome in order for the guide to become really beginner-friendly and useful.

Thank you in advance.

8 Likes
2

Very good tutorial.
Due to time constraints, I only tested a few commands. They should work fine in Linux Bash and Windows Git Bash, but they fail in PowerShell. I submitted an issue; you can take a look.

4 Likes
3

Thanks for testing it and for opening the GitHub issue @joii2020

You found a real PowerShell-specific problem.

I updated the PowerShell examples to pipe the JSON body into curl.exe and send it with --data-binary "@-", as you suggested.

1 Like