docs: Update headings and texts for community engagement sections#372
docs: Update headings and texts for community engagement sections#372freya-docs wants to merge 5 commits intohiero-ledger:mainfrom
Conversation
Signed-off-by: freya-docs <freya.docs.pp@gmail.com>
✅ Deploy Preview for hiero-open-source ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
|
Warning Rate limit exceeded
Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 13 minutes and 49 seconds. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. 📝 WalkthroughWalkthroughUpdated copy for three homepage sections in Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~2 minutes Possibly related PRs
Suggested reviewers
Poem
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 inconclusive)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
Up to standards ✅🟢 Issues
|
| Metric | Results |
|---|---|
| Complexity | 0 |
| Duplication | 0 |
TIP This summary will be updated as you push new changes. Give us feedback
exploreriii
left a comment
There was a problem hiding this comment.
I really like your approach, but I have a doubt if it is the correct approach in this context for Hiero.
The terms you are using:
explore to contribute, join the discussion, dive into codebase
While very welcoming, to me signify 'light' or surface level, perpetuating a light separation between existing contributors that are central and new contributors that are poking around. While core contributors will realistically be creating the majority of the code, ideally we can frame things like the community could play a major role, and has the ability to
The current phrasing does subtly position newcomers as observers or agents in things that cause them enjoyment, rather than active or meaningful participants that we need.
There are two competing goals here:
1.Reduce intimidation (make it easy to start)
2.Signal legitimacy and ownership (contributors matter)
Right now, your language leans heavily toward (1), at the expense of (2)
i.e. it frames new contribution as optional, peripheral, or exploratory, rather than, you can shape the system and be core to parts.
e.g.
Have a look at the issues... get 'started'
Join the discussion ... stay in the background, maybe say some things here and there, but not participate much
Dive into codebase ... have a look, tinker around.
I think shifting to something where participation is still invited but with more consequence would be ideal, yet we cannot be unrealistic (some repos are more open, contributors will take long periods of time etc to qualify for core responsibilities)
So a shift towards harder active verbs with clearer, more practical pathways would be more brand consitent, in my view.
e.g.
Contribute to Hiero?
Participate in the conversations?
Study the codebase?
So in summary i wonder your thoughts on e.g. less of a jump in / dive around and more of a meaningfully contribute, we want to build more relationships with the community?
e.g.
Contribute to Hiero
Contributors at all levels can influence the direction of Hiero—through code, documentation, and design.
Work on issues, propose improvements, and contribute to systems that are actively used across the ecosystem.?
?
Sorry I am not very creative to offer many ideas in this sense.
Signed-off-by: freya-docs <freya.docs.pp@gmail.com>
Signed-off-by: freya-docs <freya.docs.pp@gmail.com>
|
@exploreriii I get you point. I've tried to rephrase to add "legitimacy and ownership" but it became too long... |
Signed-off-by: freya-docs <freya.docs.pp@gmail.com>
Description
This PR updates headings and texts for community engagement sections to make them them more action related and welcoming.
Related Issues
Closes: #352
Summary by CodeRabbit