Skip to content

docs: fix Title Case section heading and fork clone URL placeholder in CONTRIBUTING.md#1407

Merged
giswqs merged 4 commits into
opengeos:mainfrom
amir-rezaei:docs/fix-contributing-heading-and-clone-url
Jul 25, 2026
Merged

docs: fix Title Case section heading and fork clone URL placeholder in CONTRIBUTING.md#1407
giswqs merged 4 commits into
opengeos:mainfrom
amir-rezaei:docs/fix-contributing-heading-and-clone-url

Conversation

@amir-rezaei

@amir-rezaei amir-rezaei commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Description

This PR updates section heading Title Case formatting and fixes the git clone URL placeholder in CONTRIBUTING.md.

Details

  1. Updated section header (## Quick start $\to$ ## Quick Start).
  2. Replaced upstream repository URL with user fork placeholder (opengeos $\to$ <your-username>).

Summary by CodeRabbit

  • Documentation
    • Reworded the “Quick Start” section heading for consistent capitalization.
    • Updated repository cloning steps to fork first, then clone using a YOUR_GITHUB_USERNAME placeholder.
    • Left the remaining Quick Start and “Before opening a pull request” instructions unchanged.

Copilot AI review requested due to automatic review settings July 24, 2026 11:30
@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 818f45f2-2508-4d1c-96f0-eb8d8f06d0ec

📥 Commits

Reviewing files that changed from the base of the PR and between cc886ad and 1ae0647.

📒 Files selected for processing (1)
  • docs/contributing.md

📝 Walkthrough

Walkthrough

Contributor documentation now directs users to fork GeoLibre and clone their fork, while the main guide’s “Quick Start” heading uses updated capitalization.

Changes

Contributor Setup Documentation

Layer / File(s) Summary
Update contributor setup instructions
CONTRIBUTING.md, docs/contributing.md
The guides use a YOUR_GITHUB_USERNAME fork URL for cloning; CONTRIBUTING.md also capitalizes the “Quick Start” heading.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

Suggested reviewers: craun718, giswqs

Poem

A rabbit forks the code with cheer,
Then clones the path made crystal-clear.
“Quick Start” hops into the light,
Carrots for docs—what a delight! 🐇

🚥 Pre-merge checks | ✅ 5
✅ 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 accurately summarizes the doc heading capitalization and fork-based clone URL placeholder changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CONTRIBUTING.md`:
- Around line 11-12: Update the Quick Start clone command in CONTRIBUTING.md to
replace the angle-bracket placeholder with a shell-safe placeholder such as
YOUR_GITHUB_USERNAME, and explicitly instruct readers to substitute it with
their GitHub username.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b593a8a1-baf1-4937-b050-242280f4f5dd

📥 Commits

Reviewing files that changed from the base of the PR and between 98ab48b and 08bc76b.

📒 Files selected for processing (1)
  • CONTRIBUTING.md

Comment thread CONTRIBUTING.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates CONTRIBUTING.md to improve contributor-facing documentation by standardizing a section heading’s Title Case and adjusting the example git clone command to reference a fork rather than the upstream repository.

Changes:

  • Updated the “Quick start” heading to “Quick Start”.
  • Replaced the example clone URL to use a user fork placeholder instead of the upstream org.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CONTRIBUTING.md Outdated
- Replace the `<your-username>` clone placeholder with the shell-safe
  `YOUR_GITHUB_USERNAME`: angle brackets are redirection operators, so
  copy/pasting the Quick Start command failed in bash/zsh before `git clone`
  ran (CodeRabbit, Copilot).
- Add a sentence above the block telling readers to fork first and substitute
  their GitHub username, so the placeholder is explicit (CodeRabbit).

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CONTRIBUTING.md`:
- Around line 11-15: Align the repository setup instructions between
CONTRIBUTING.md and docs/contributing.md so both direct contributors to the same
clone workflow. Update the linked guide to use the fork-based URL, or clearly
designate one document as canonical and link to it, eliminating conflicting
instructions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 085de5b5-49a2-47d2-9e04-267973796687

📥 Commits

Reviewing files that changed from the base of the PR and between 08bc76b and cc886ad.

📒 Files selected for processing (1)
  • CONTRIBUTING.md

Comment thread CONTRIBUTING.md
giswqs added 2 commits July 24, 2026 20:35
- Align docs/contributing.md with CONTRIBUTING.md: the canonical guide still
  cloned opengeos/GeoLibre directly while the root file now tells contributors
  to clone their fork, so the two gave conflicting setup steps. Both now use
  the fork-based clone with the shell-safe YOUR_GITHUB_USERNAME placeholder.
@giswqs
giswqs merged commit 0839419 into opengeos:main Jul 25, 2026
20 of 21 checks passed
giswqs added a commit to amir-rezaei/GeoLibre that referenced this pull request Jul 25, 2026
…e-url

Resolves the conflict created when opengeos#1407 merged the same CONTRIBUTING.md
change ahead of this branch.

- Both conflicts were the clone placeholder. Kept main's
  `YOUR_GITHUB_USERNAME` over this branch's `<your-username>`: angle brackets
  are shell redirection operators, so the command failed on paste, which both
  Copilot and CodeRabbit flagged on opengeos#1407.
- Kept this branch's `## Ways to Contribute` heading, the only change here not
  already on main.
- Replaced the em dash in the fork sentence with a period in both files.
giswqs added a commit to amir-rezaei/GeoLibre that referenced this pull request Jul 25, 2026
Resolves the conflict created when opengeos#1407 and opengeos#1408 landed the contributor-guide
changes this branch was stacked on.

- Both conflicts were the clone placeholder. Kept main's
  `YOUR_GITHUB_USERNAME` over this branch's `<your-username>`: angle brackets
  are shell redirection operators, so the command failed on paste.
- The branch now carries only the CITATION.cff DOI quoting, matching the PR
  title and description.
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