Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(docs): i18n support added to docs #69

Merged
merged 9 commits into from
Jun 29, 2024
Merged

feat(docs): i18n support added to docs #69

merged 9 commits into from
Jun 29, 2024

Conversation

tankerkiller125
Copy link
Contributor

@tankerkiller125 tankerkiller125 commented Jun 28, 2024

Adds i18n support to the documentation so that those that speak other languages can start adding their own preferred languages.

Summary by CodeRabbit

  • New Features

    • Introduced English language settings and paths in documentation for better localization.
    • Added detailed 'Bounty Program' information to guide contributors and sponsors.
    • Added comprehensive 'Getting Started' guide for new contributors.
  • Improvements

    • Updated internal documentation links to be language-specific (e.g., /en/quick-start).
  • Chores

    • Updated package.json to specify the package manager and version (pnpm@9.1.4).

Copy link
Contributor

coderabbitai bot commented Jun 28, 2024

Warning

Rate limit exceeded

@katosdev has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 24 minutes and 37 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

Files that changed from the base of the PR and between 3e00f0c and 4995e04.

Walkthrough

The recent changes expand and refine the documentation, particularly for English users. The config.mts file now supports English locales, and documentation links have been updated to include language prefixes. New files provide comprehensive guides on contributing to the project and participating in the Bounty Program. The package.json update includes a specific version of pnpm as the package manager.

Changes

Files/Paths Change Summary
docs/.vitepress/config.mts Added English locales, restructured sidebar, updated links for "Quick Start" and "Tips and Tricks" to include /en/ prefix.
docs/en/contribute/bounty.md Introduced Bounty Program information, outlining how to engage with bounties using boss.dev.
docs/en/contribute/get-started.md Detailed guidelines for newcomers on contributing to the project, including setup and branch flow.
docs/en/index.md Updated links for "Quick Start" and "Tips and Tricks" to include /en/ prefix.
package.json Added packageManager key specifying the pnpm version and its SHA hash.

Poem

In the code where changes roam,
New locales find a home, 🏠
With bounties set to blaze,
Contributions start to craze.
Quick starts now in English light,
Tips and tricks in perfect sight. ✨
pnpm leads the package fight.


Tip

Early access features
  • OpenAI gpt-4o model for reviews and chat.

Note:

  • You can disable early access features from the CodeRabbit UI or by setting early_access: false in the CodeRabbit configuration file.
  • Please join our Discord Community to provide feedback and report issues.
  • OSS projects are always opted into early access features.

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share
Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (invoked as PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Additionally, you can add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.

CodeRabbit Configration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

cloudflare-workers-and-pages bot commented Jun 28, 2024

Deploying homebox-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4995e04
Status: ✅  Deploy successful!
Preview URL: https://d7442aac.homebox-docs.pages.dev
Branch Preview URL: https://docs-i18n.homebox-docs.pages.dev

View logs

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: 8

Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

Commits

Files that changed from the base of the PR and between a3f4c97 and 3e00f0c.

Files selected for processing (7)
  • docs/.vitepress/config.mts (2 hunks)
  • docs/en/contribute/bounty.md (1 hunks)
  • docs/en/contribute/get-started.md (1 hunks)
  • docs/en/index.md (1 hunks)
  • docs/en/tips-tricks.md (1 hunks)
  • docs/public/_redirects (1 hunks)
  • package.json (1 hunks)
Files not reviewed due to errors (2)
  • docs/en/index.md (no review received)
  • docs/en/tips-tricks.md (no review received)
Files skipped from review due to trivial changes (2)
  • docs/public/_redirects
  • package.json
Additional context used
LanguageTool
docs/en/contribute/bounty.md

[uncategorized] ~6-~6: A comma might be missing here.
Context: ... issues. After digging through several platforms we ended up settling on https://www.bos...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)


[style] ~8-~8: For conciseness, consider replacing this expression with an adverb.
Context: ...k it's about the best one we could find at the moment to lower the rates as much as possible ...

(AT_THE_MOMENT)


[style] ~8-~8: Using many exclamation marks might seem excessive (in this case: 3 exclamation marks for a text that’s 1359 characters long)
Context: ... we found were as high as a combined 16%!!!) We hope that by enabling bounties on ...

(EN_EXCESSIVE_EXCLAMATION)


[uncategorized] ~10-~10: A comma might be missing here.
Context: ...nted quicker can sponsor issues, and in turn everyone contributing code can potentia...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)


[uncategorized] ~13-~13: Possible missing comma found.
Context: ...ontributor wanting to accept money from bounties you simply need to register for an acco...

(AI_HYDRA_LEO_MISSING_COMMA)

docs/en/contribute/get-started.md

[uncategorized] ~22-~22: Possible missing comma found.
Context: ... that when installing dependencies with pnpm you must use the --shamefully-hoist f...

(AI_HYDRA_LEO_MISSING_COMMA)


[style] ~22-~22: Although a hyphen is possible, it is not necessary in a compound modifier in which the first word is an adverb that ends in ‘ly’.
Context: ...dependencies with pnpm you must use the --shamefully-hoist flag. If you don't use this flag, you ...

(HYPHENATED_LY_ADVERB_ADJECTIVE)


[uncategorized] ~27-~27: You might be missing the article “the” here.
Context: ...t Notes start command task go:run 1. API Server does not auto reload. You'll nee...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)


[uncategorized] ~27-~27: It appears that a hyphen is missing (if ‘auto’ is not used in the context of ‘cars’).
Context: ...d task go:run 1. API Server does not auto reload. You'll need to restart the server afte...

(AUTO_HYPHEN)


[uncategorized] ~50-~50: The official spelling of this programming framework is “Node.js”.
Context: ...cumentation contributions you only need NodeJS and PNPM. ::: info Notes - Languages a...

(NODE_JS)


[grammar] ~54-~54: In this context, “per-language” forms an adjective and is spelled with a hyphen.
Context: ...tc.) - The Sidebar must be updated on a per language basis - Each languages files can be nam...

(PER_USER_BASIS_HYPHEN)


[uncategorized] ~55-~55: The grammatical number of this noun doesn’t look right. Consider replacing it.
Context: ... updated on a per language basis - Each languages files can be named independently (slugs...

(AI_EN_LECTOR_REPLACEMENT_NOUN_NUMBER)


[typographical] ~62-~62: It seems that a comma is missing.
Context: ...form a feature branch. To create a pull request you can use the following steps: 1. Fo...

(IN_ORDER_TO_VB_COMMA)


[uncategorized] ~66-~66: A comma might be missing here.
Context: ... tested, add tests 3. If you've changed APIs update the documentation 4. Ensure that...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)

docs/en/index.md

[uncategorized] ~37-~37: Possible missing comma found.
Context: ...equires minimal resources to deploy. In general idle memory usage is less than 50MB for...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~47-~47: Possible missing comma found.
Context: ... so many robust features and management options which makes it easy to become overwhelm...

(AI_HYDRA_LEO_MISSING_COMMA)


[style] ~51-~51: To elevate your writing, try using a synonym here.
Context: ...y when you have a lot of data, and it's hard to keep track of what's where. I also w...

(HARD_TO)


[style] ~51-~51: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...ust way than a spreadsheet can provide. I also wanted to leave the door open for ...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[uncategorized] ~55-~55: Possible missing comma found.
Context: ...tems and managing them is a key goal of Homebox which means you lose out on some of the...

(AI_HYDRA_LEO_MISSING_COMMA)

docs/en/tips-tricks.md

[uncategorized] ~26-~26: It appears that a hyphen is missing (if ‘auto’ is not used in the context of ‘cars’).
Context: ...approaches to manage Asset IDs: ### 1. Auto Incrementing IDs This is the default behavior likel...

(AUTO_HYPHEN)


[uncategorized] ~30-~30: It appears that a hyphen is missing (if ‘auto’ is not used in the context of ‘cars’).
Context: ... is recommended for most users. ### 2. Auto Incrementing IDs with Reset In some cases, you may ...

(AUTO_HYPHEN)


[style] ~56-~56: The phrase “a variety of” may be wordy. To make your writing clearer, consider replacing it.
Context: ...his allows you to send notifications to a variety of services. On your profile page, you can...

(A_VARIETY_OF)


[uncategorized] ~56-~56: Possible missing comma found.
Context: ..., you can add notification URLs to your profile which will be used to send notification...

(AI_HYDRA_LEO_MISSING_COMMA)

Markdownlint
docs/en/contribute/bounty.md

3-3: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


12-12: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


15-15: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


18-18: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


6-6: null
Bare URL used

(MD034, no-bare-urls)


19-19: null
Bare URL used

(MD034, no-bare-urls)


19-19: null
Files should end with a single newline character

(MD047, single-trailing-newline)

docs/en/contribute/get-started.md

70-70: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)


24-24: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


48-48: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


60-60: Expected: 1; Actual: 0; Below
Headings should be surrounded by blank lines

(MD022, blanks-around-headings)


53-53: null
Lists should be surrounded by blank lines

(MD032, blanks-around-lists)

docs/en/index.md

44-44: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)

docs/en/tips-tricks.md

62-62: Expected: 1; Actual: 2
Multiple consecutive blank lines

(MD012, no-multiple-blanks)


58-58: Expected: underscore; Actual: asterisk
Strong style

(MD050, strong-style)


58-58: Expected: underscore; Actual: asterisk
Strong style

(MD050, strong-style)


69-69: Expected: underscore; Actual: asterisk
Strong style

(MD050, strong-style)


69-69: Expected: underscore; Actual: asterisk
Strong style

(MD050, strong-style)

Additional comments not posted (2)
docs/.vitepress/config.mts (2)

12-17: Locale configuration added successfully.

The locale configuration for English has been correctly added. This is a crucial part of supporting multiple languages on the site.


34-57: Sidebar configuration for internationalization.

The sidebar configuration has been updated to include sections for English content and contributing. This aligns with the project's goal of supporting multiple languages.

@katosdev katosdev self-requested a review June 29, 2024 17:08
@katosdev katosdev merged commit 76fe0d3 into main Jun 29, 2024
4 checks passed
@tankerkiller125 tankerkiller125 deleted the docs/i18n branch July 2, 2024 15:43
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.

2 participants