Skip to content

docs: request leave (day-off)#86

Merged
zolotokrylin merged 11 commits intomainfrom
docs/view-how-to-request-for-leave
Feb 12, 2026
Merged

docs: request leave (day-off)#86
zolotokrylin merged 11 commits intomainfrom
docs/view-how-to-request-for-leave

Conversation

@williamrusdyputra
Copy link
Contributor

@williamrusdyputra williamrusdyputra commented Feb 10, 2026

resolves: https://github.com/holdex/wizard/issues/853

Summary by CodeRabbit

Release Notes

  • Documentation
    • Streamlined leave request process with clearer, step-by-step workflow
    • Added guidance on valid leave types and date range specifications
    • Introduced automated leave tracking and summary system
    • Enhanced policy documentation with practical examples

@williamrusdyputra williamrusdyputra self-assigned this Feb 10, 2026
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 10, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

Walkthrough

Updated the leave request process documentation from a single form-based submission to a Git-based workflow. The new process involves creating a branch in the HR repository, editing a leave.yaml file with entries for scheduled or taken leave, creating a pull request for approval, and receiving automatic leave summary recording upon merge.

Changes

Cohort / File(s) Summary
Leave Policy Documentation
docs/LEAVE_POLICY.md
Restructured leave request workflow with step-by-step Git-based process, added YAML configuration examples, introduced new sections for valid leave types and date ranges, and integrated automated leave summary functionality.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

  • markholdex
  • zolotokrylin
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed The PR updates leave request documentation as required by issue #853, replacing outdated submission process with new structured workflow and guidance.
Out of Scope Changes check ✅ Passed All changes focus on updating the leave request documentation; no unrelated modifications detected outside the stated objective.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The title "docs: request leave (day-off)" accurately and concisely describes the main change—updating documentation on how to request leave.

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

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/view-how-to-request-for-leave

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.


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.

@williamrusdyputra williamrusdyputra changed the title docs: view updated how to request for leave docs: view updated guide on how to request leave Feb 10, 2026
@williamrusdyputra williamrusdyputra marked this pull request as ready for review February 10, 2026 05:36
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: 3

🤖 Fix all issues with AI agents
In `@docs/LEAVE_POLICY.md`:
- Around line 32-33: Add required blank lines before each fenced code block and
before the list under the "Automated Leave Summary" heading: insert a single
blank line between the "Example:" line and the following ```yaml fence, and
insert a blank line between the sentence "You can use ranges for multi-day
leave:" and the following ```yaml fence; similarly, add a blank line between
"Every day at midnight UTC, the system automatically:" and the start of the list
item "- Calculates your leave balance..." and apply the same blank-line fixes to
the other occurrences referenced (lines around 58-60 and 66-67) so every fenced
code block and list has a preceding blank line.
- Around line 26-46: The ordered list numbering in the docs block should use the
"one." style required by the linter; update the list items so every step uses
"1." and keep the content intact (items referencing leave.yaml,
daysOff.scheduled, and daysOff.taken should remain unchanged), i.e., change the
current leading numbers for steps 2–6 to "1." so the entire sequence is numbered
with repeated "1." entries.
- Line 46: The markdown line "6. **After merge** - your leave is recorded and
will appear in the automated summary" exceeds 80 chars and should be wrapped to
satisfy MD013; edit the "6. **After merge** ..." line in LEAVE_POLICY.md and
split it into two shorter lines or sentences (for example break after "After
merge" or before "and will appear") so each line is <=80 characters while
preserving the same wording and emphasis.

@holdex
Copy link

holdex bot commented Feb 10, 2026

Time Submission Status

Member Status Time Action Last Update
williamrusdyputra ✅ Submitted 50min Update time Feb 12, 2026, 8:25 AM
tiffmyaaw ✅ Submitted 20min Update time Feb 12, 2026, 8:25 AM
zolotokrylin ✅ Submitted 12min Update time Feb 12, 2026, 8:25 AM
markholdex ✅ Submitted 10min Update time Feb 12, 2026, 8:25 AM

You can submit time with the command. Example:

@holdex pr submit-time 15m

See available commands to help comply with our Guidelines.

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 `@docs/LEAVE_POLICY.md`:
- Line 73: Clarify the ambiguous "HR issue" phrase by updating the sentence
"Updates your HR issue with a detailed leave summary" to explicitly state where
to find or create the HR issue (for example: "Updates your HR issue (the ticket
in the HR ticketing system/People Ops portal or the 'hr-requests' Slack channel)
with a detailed leave summary"), so readers know which system or location to
use; edit the LEAVE_POLICY.md line containing "HR issue" accordingly.
- Around line 40-42: Replace the past example date "2026-01-15" in the scheduled
leave YAML example with a future date (e.g., update the value of the date field
in the example entry that currently has date: 2026-01-15) so the sample shows a
valid upcoming leave; ensure the format remains YYYY-MM-DD and the other fields
(type: vacation, notes: Family trip) are unchanged.

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 `@docs/LEAVE_POLICY.md`:
- Around line 67-68: The Markdown has a missing blank line before the fenced
code block starting with "```yaml" after the sentence "or for multi-day but
separated, you can simply add more items on 1 PR:", which triggers MD031; add a
single blank line between that sentence and the code fence so the code block is
separated by an empty line and the lint rule passes.

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 `@docs/CONTRIBUTING.md`:
- Around line 138-140: The MD013 line-length warning comes from the long inline
link to "GitHub's documentation on commit signature verification"; fix it by
either inserting a markdownlint disable comment immediately before that link
line (<!-- markdownlint-disable-next-line MD013 -->) or converting the inline
URL to a reference-style link (replace the long inline URL with a short
reference like [GitHub's documentation][gh-signature] and add the full URL at
the bottom as [gh-signature]:
https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification)
so the content containing "GitHub's documentation on commit signature
verification" no longer exceeds the configured line length.

Copy link
Contributor

@tiffmyaaw tiffmyaaw left a comment

Choose a reason for hiding this comment

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

My only comment is about the PR, as per our guideline each PR should link to an issue, it doesn't make sense to create a PR without referencing it to an issue first.

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 `@docs/LEAVE_POLICY.md`:
- Line 31: The line "You can define which days you are requesting on the issue
description, even if the days are separated like 12th, 14th, etc." exceeds 80
characters—wrap it to multiple shorter lines (<=80 chars) in LEAVE_POLICY.md so
it fits the max line length; split the sentence at a natural break (for example
after "issue description,") or rewrite into two sentences preserving the meaning
(e.g., one line explaining that days can be listed and a second line with the
example "12th, 14th, etc.").

Copy link
Contributor

@tiffmyaaw tiffmyaaw left a comment

Choose a reason for hiding this comment

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

This is so far so good in my opinion 😃

@williamrusdyputra
Copy link
Contributor Author

@markholdex could you check this doc, thank you

Copy link
Member

@zolotokrylin zolotokrylin left a comment

Choose a reason for hiding this comment

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

I am not rejecting, as it is not completely wrong, but:

  • move the HOW instruction inside the wizard docs, similar to: https://wizard.holdex.io/docs
  • in this README just leave a reference to the instructions

@williamrusdyputra
Copy link
Contributor Author

Yes, I will move it there when this is decided:

to avoid re-writing in case of any change.

@zolotokrylin
Copy link
Member

@williamrusdyputra, this is not blocking:

The mentioned issue is an independent product iteration and therefore not included in the current scope.

Copy link
Contributor

@markholdex markholdex left a comment

Choose a reason for hiding this comment

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

@williamrusdyputra should we just link to the official docs instead of maintaining 2 places? https://wizard.holdex.io/docs/leave-request

Otherwise I need to reject your PR because it mismatches our official docs.

@williamrusdyputra
Copy link
Contributor Author

@williamrusdyputra should we just link to the official docs instead of maintaining 2 places? https://wizard.holdex.io/docs/leave-request

Otherwise I need to reject your PR because it mismatches our official docs.

yes, that's my plan also

@zolotokrylin zolotokrylin changed the title docs: view updated guide on how to request leave docs: request leave (day-off) Feb 12, 2026
@zolotokrylin zolotokrylin merged commit a3fb2d9 into main Feb 12, 2026
6 checks passed
@zolotokrylin zolotokrylin deleted the docs/view-how-to-request-for-leave branch February 12, 2026 08:25
@zolotokrylin
Copy link
Member

@holdex pr submit-time 12m

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.

4 participants

Comments