Skip to content

Comments

docs: read compensation guide#23

Merged
zolotokrylin merged 16 commits intomainfrom
zolotokrylin-patch-1
Nov 7, 2025
Merged

docs: read compensation guide#23
zolotokrylin merged 16 commits intomainfrom
zolotokrylin-patch-1

Conversation

@zolotokrylin
Copy link
Member

@zolotokrylin zolotokrylin commented Feb 26, 2024

resolves https://github.com/holdex/hr/issues/102

Summary by CodeRabbit

  • Documentation
    • Clarified contribution guidelines: wording changed to singular “Pull Request (PR)”, reworked drafting into a clear three-step checklist for starting work, and improved phrasing/formatting.
    • Added a compensation guide: outlines core compensation principles, a tiered expectations framework (Entry → Principal), a growth path, and links to related resources.
    • Updated README to link the new Compensation Guide.

@zolotokrylin zolotokrylin marked this pull request as ready for review February 26, 2024 10:14
@holdex
Copy link

holdex bot commented Apr 8, 2024

Hi @zolotokrylin
Your PR cost submitted: 1 hours.
View submission on.

@holdex
Copy link

holdex bot commented Nov 7, 2025

Time Submission Status

Member Status Time Action Last Update
zolotokrylin ✅ Submitted 1h Update time Nov 7, 2025, 7:09 AM

Signed-off-by: Vadim <vadim@holdex.io>
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 7, 2025

Warning

Rate limit exceeded

@zolotokrylin has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 6 minutes and 8 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

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.

📥 Commits

Reviewing files that changed from the base of the PR and between 3b3d89d and e3edd8d.

📒 Files selected for processing (3)
  • .github/DONTS.md (0 hunks)
  • .github/PRINCIPLES.md (1 hunks)
  • README.md (1 hunks)

Walkthrough

Update CONTRIBUTING.md to prefer singular "Pull Request (PR)" and reformat the Drafting section into a numbered three-step process (open draft PR, link to Problem, assign reviewer). Add a new COMPENSATION.md describing compensation principles, tiered expectations, and growth guidance.

Changes

Cohort / File(s) Change Summary
Contribution guidelines
​.github/CONTRIBUTING.md
Replace "Pull Requests (PR)" with "Pull Request (PR)". Rewrite Drafting section into a numbered three-step workflow: 1) open a draft PR immediately, 2) link the opened PR to the corresponding Problem, 3) assign at least one reviewer before marking the PR ready; update wording and checklist formatting.
Compensation guide (new)
​.github/COMPENSATION.md, README.md
Add new COMPENSATION.md containing compensation principles (clear incentives, resilient framework), a four-level expectations framework (Entry → Principal) covering Team culture, Goals, Problems & Solutions, and growth/"Looking forward" guidance with links. Update README.md to include a "Compensation Guide" link under "Align with".

Sequence Diagram(s)

sequenceDiagram
  participant Contributor as Contributor
  participant Repo as Repository
  participant Problem as Problem Tracker
  participant Reviewer as Reviewer

  rect rgb(235,245,255)
  Note over Contributor,Repo: Drafting workflow (new)
  Contributor->>Repo: Open draft Pull Request (PR)
  Repo-->>Contributor: Draft PR created
  Contributor->>Problem: Link PR to Problem
  Problem-->>Repo: Association recorded
  Contributor->>Reviewer: Assign at least one reviewer
  Reviewer-->>Repo: Reviewer assigned
  Contributor->>Repo: Mark PR ready (after review assigned)
  end
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Documentation-only changes across two files (one targeted edit, one new longer doc).
  • Pay attention to:
    • Links and external targets in ​.github/COMPENSATION.md
    • Numbering and checklist formatting in ​.github/CONTRIBUTING.md
    • README link correctness

Suggested reviewers

  • markholdex
  • angelicawill

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: read compensation guide' directly reflects the main change: adding a new compensation guide document and linking it in README.md.
Linked Issues check ✅ Passed The PR completes two of three coding-related objectives from issue #102: moving the compensation guide into holdex/developers and adding it to the repository with documentation links.
Out of Scope Changes check ✅ Passed All changes (new COMPENSATION.md, CONTRIBUTING.md updates, README.md link) are directly aligned with resolving issue #102 requirements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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.

Added a comprehensive compensation guide outlining principles, expectations, and team culture for various roles.

Signed-off-by: Vadim <vadim@holdex.io>
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

🧹 Nitpick comments (2)
.github/COMPENSATION.md (2)

1-11: Tighten wording in compensation principles.

Line 7 uses "end results" which is slightly wordy. Consider simplifying to "results" for conciseness.

-* Clear incentives . All salaries and bonuses are based on a simple merit system. The more you contribute by independently delivering end results, the more rewards you will receive. Doing the same job at the same level is paid the same regardless of location or other factors.
+* Clear incentives . All salaries and bonuses are based on a simple merit system. The more you contribute by independently delivering results, the more rewards you will receive. Doing the same job at the same level is paid the same regardless of location or other factors.

54-63: Remove informal language and strengthen word choice.

The section uses several instances of informal or weak language inconsistent with professional documentation:

  • Line 56: "haha" is too casual; remove or replace with "though"
  • Lines 61–63: "amazing" (2×) is informal; use "excellent" or "exceptional"
  • Line 62: "very strong point of view" — "very" is a weak intensifier; use "strong" alone
  • Line 61: "Be comfortable with being" should be "Be comfortable being"

Also apply these word-choice fixes in the HTML refactor above.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 379c522 and b0ea6f4.

📒 Files selected for processing (1)
  • .github/COMPENSATION.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
.github/COMPENSATION.md

[style] ~7-~7: ‘end results’ might be wordy. Consider a shorter alternative.
Context: ... contribute by independently delivering end results, the more rewards you will receive. Doi...

(EN_WORDINESS_PREMIUM_END_RESULTS)


[style] ~56-~56: To elevate your writing, try using a synonym here.
Context: ...we’d love that, haha). Some of them are hard to pack or to remember. Others get blur...

(HARD_TO)


[style] ~61-~61: Consider using a more formal and expressive alternative to ‘amazing’.
Context: ...s, devs, and so on) to make the project amazing.
* Inspire others. Become someone ou...

(AWESOME)


[style] ~61-~61: Consider using “comfortable being”.
Context: ...ry members when they are stuck.
* Be comfortable with being on the business side of things. (discus...

(COMFORTABLE_WITH_VBG)


[style] ~62-~62: Consider using a more formal and expressive alternative to ‘amazing’.
Context: ...r>* Be able to join the action and show amazing crafting skills when needed.
* Becom...

(AWESOME)


[style] ~62-~62: As an alternative to the over-used intensifier ‘very’, consider replacing this phrase.
Context: ...tion to big-picture strategy.
* Have very strong point of view but open to other people’...

(EN_WEAK_ADJECTIVE)

🪛 markdownlint-cli2 (0.18.1)
.github/COMPENSATION.md

60-60: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


60-60: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


60-60: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


60-60: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


61-61: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


62-62: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)


63-63: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)

🔇 Additional comments (1)
.github/COMPENSATION.md (1)

12-53: Framework tables are well-structured and clear.

The three-level progression across Team culture, Goals, and Problems & Solutions is easy to understand and provides good visual clarity for the tiered expectations.

Signed-off-by: Vadim <vadim@holdex.io>
Signed-off-by: Vadim <vadim@holdex.io>
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: 0

🧹 Nitpick comments (1)
.github/COMPENSATION.md (1)

15-18: Consider minor wording refinements for formality and clarity.

Two suggestions:

  1. Line 17: "Distribute to best fit" → "Distribute to the best fit" (article usage)
  2. Line 15–18: Capitalization inconsistency—some cells use sentence case ("Execute tasks") while others use sentence fragments ("Student mindset:"). Standardize for consistency.
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 42a1f70 and 3b3d89d.

📒 Files selected for processing (1)
  • .github/COMPENSATION.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
.github/COMPENSATION.md

[uncategorized] ~17-~17: The preposition ‘as’ seems more likely in this position.
Context: ...Ensure delivery. | Delegate. Distribute to best fit. | | Partner | Big-picture...

(AI_HYDRA_LEO_REPLACE_TO_AS)

🔇 Additional comments (4)
.github/COMPENSATION.md (4)

1-10: Clear and well-structured opening with strong positioning.

The header establishes the core philosophy effectively, and the Core Rules section clearly communicates the two foundational principles. The link placement is helpful for context.


11-18: Verify level naming consistency: "Partner" vs. "Principal".

The AI summary references four levels as "Entry, Intermediate, Lead, Principal," but the code uses "Partner" instead. Confirm this is intentional or update for consistency with internal documentation.


13-18: Ensure external links remain valid and complete.

The document references multiple external URLs (lines 5, 15, 16, 17, 18):

  • https://holdex.io/c/jobs
  • https://holdex.io/about
  • https://holdex.io/c/learn/principles
  • https://holdex.io/c/learn/github-strategy

Verify these endpoints exist and will remain stable. Also note that PR objective #3 ("Redirect https://holdex.io/c/learn/compensation-guide to the relevant holdex/developers page") is not yet in scope—plan for that separately.


1-27: Overall: Clear compensation framework document ready for publication.

The document successfully establishes a tiered compensation and growth framework with clear principles, expectations per level, and progression paths. The structure is logical and the content is accessible. Ensure the level naming is consistent with internal references and external links are stable before publication.

Signed-off-by: Vadim <vadim@holdex.io>
Signed-off-by: Vadim <vadim@holdex.io>
Signed-off-by: Vadim <vadim@holdex.io>
Removed link to DOs & DON'Ts from the README.

Signed-off-by: Vadim <vadim@holdex.io>
Signed-off-by: Vadim <vadim@holdex.io>
@zolotokrylin zolotokrylin merged commit 31470a3 into main Nov 7, 2025
2 checks passed
@zolotokrylin zolotokrylin deleted the zolotokrylin-patch-1 branch November 7, 2025 07:12
@coderabbitai coderabbitai bot mentioned this pull request Nov 29, 2025
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.

1 participant