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

update the quick start doc to reflect the latest changes #5116

Merged
merged 1 commit into from
Mar 31, 2024

Conversation

nobodyiam
Copy link
Member

@nobodyiam nobodyiam commented Mar 31, 2024

What's the purpose of this PR

update the quick start doc to reflect the latest changes

Follow this checklist to help us incorporate your contribution quickly and easily:

  • Read the Contributing Guide before making this pull request.
  • Write a pull request description that is detailed enough to understand what the pull request does, how, and why.
  • Write necessary unit tests to verify the code.
  • Run mvn clean test to make sure this pull request doesn't break anything.
  • Update the CHANGES log.

Summary by CodeRabbit

  • Documentation
    • Updated the English and Chinese Quick Start guides for the Apollo project.
    • Included instructions for database service discovery.
    • Provided updated steps for initializing the Apollo Configuration Center with new profile names and database configurations.
    • Added guidance on initializing sample configurations and creating applications.
    • Updated illustrations in the quick start guide.

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Mar 31, 2024
Copy link

coderabbitai bot commented Mar 31, 2024

Warning

Rate Limit Exceeded

@nobodyiam has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 9 minutes and 6 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 c255389 and 057d401.

Walkthrough

The updates focus on enhancing the apollo-quick-start project setup and configuration process. Key improvements include introducing a database-discovery environment variable for better database service discovery and detailed instructions for initializing the Apollo Configuration Center. Both English and Chinese documentation reflect these changes, with updates to project references, environment variable profiles, and startup commands. The Chinese guide now includes steps for initializing sample configurations and creating applications, along with updated illustrative images.

Changes

File Path Change Summary
docs/.../quick-start.md Renamed project to apollo-quick-start, updated environment variables for database-discovery, adjusted initialization instructions and startup commands, added steps for sample configurations and application creation (ZH), updated image URLs (ZH).

🐇✨
In the world of code, where changes abound,
A rabbit hopped in, with updates profound.
"Let's quick-start," it said, with a twirl,
"Apollo's new journey, ready to unfurl."
With discovery and steps so clearly penned,
Our guide now complete, on this path we ascend.
🚀🌟

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.

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 a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @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.
  • The JSON schema for the configuration file is available here.
  • 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/coderabbit-overrides.v2.json

CodeRabbit Discord Community

Join our Discord Community to get help, request features, and share feedback.

Copy link

codecov bot commented Mar 31, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 50.29%. Comparing base (c255389) to head (057d401).

Additional details and impacted files
@@             Coverage Diff              @@
##             master    #5116      +/-   ##
============================================
- Coverage     50.30%   50.29%   -0.01%     
+ Complexity     2011     2010       -1     
============================================
  Files           388      388              
  Lines         12216    12216              
  Branches       1207     1207              
============================================
- Hits           6145     6144       -1     
  Misses         5708     5708              
- Partials        363      364       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link

@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: 6

Review Status

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between c255389 and beb76bf.
Files selected for processing (2)
  • docs/en/deployment/quick-start.md (11 hunks)
  • docs/zh/deployment/quick-start.md (10 hunks)
Additional Context Used
Additional comments not posted (8)
docs/zh/deployment/quick-start.md (4)

52-52: The project reference has been updated to apollo-quick-start. Ensure that all links and references throughout the documentation are consistent with this change.


72-72: The inclusion of database-discovery in the environment variable profiles is a significant update. Ensure that the documentation elsewhere is updated to reflect how to use this new profile effectively.


78-78: The documentation now includes detailed steps for initializing the Apollo Configuration Center with different database configurations. This is a valuable addition for users. Ensure that these steps are tested thoroughly to prevent any issues for new users following the guide.

Also applies to: 92-92, 106-106, 125-125, 143-143, 170-170


194-194: The update to visual aids with new image URLs is a great improvement for the learning experience. Verify that all new URLs are accessible and that the images correctly represent the described steps.

Also applies to: 199-199, 203-203, 207-207, 211-211, 215-215, 236-236, 248-248, 250-250, 255-255, 262-262

Verification successful

The verification process confirmed that all new image URLs are accessible, as they all returned a 200 HTTP status code. This indicates that the images are likely correctly representing the described steps and are available for users to view.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Verify accessibility of new image URLs
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-login.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-sample-home.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-create-sample-app.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-create-sample-config.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/sample-app-config.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/sample-app-release-detail.jpg

Length of output: 1010

docs/en/deployment/quick-start.md (4)

52-52: The project reference has been updated to apollo-quick-start. Ensure that all links and references throughout the documentation are consistent with this change.


72-72: The inclusion of database-discovery in the environment variable profiles is a significant update. Ensure that the documentation elsewhere is updated to reflect how to use this new profile effectively.


77-77: The documentation now includes detailed steps for initializing the Apollo Configuration Center with different database configurations. This is a valuable addition for users. Ensure that these steps are tested thoroughly to prevent any issues for new users following the guide.

Also applies to: 91-91, 105-105, 124-124, 142-142, 169-169


193-193: The update to visual aids with new image URLs is a great improvement for the learning experience. Verify that all new URLs are accessible and that the images correctly represent the described steps.

Also applies to: 198-198, 202-202, 206-206, 210-210, 214-214, 235-235, 247-247, 249-249, 254-254, 261-261

Verification successful

The verification process confirms that all new image URLs are accessible, as indicated by the HTTP status code 200 for each URL tested. This ensures that the images are correctly accessible and can be used as visual aids in the documentation.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Verify accessibility of new image URLs
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-login-en.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-sample-home-en.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-create-sample-app-en.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/apollo-create-sample-config-en.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/sample-app-config-en.jpg
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://cdn.jsdelivr.net/gh/apolloconfig/apollo-quick-start@master/images/sample-app-release-detail-en.jpg

Length of output: 1028

docs/zh/deployment/quick-start.md Show resolved Hide resolved
docs/zh/deployment/quick-start.md Show resolved Hide resolved
docs/en/deployment/quick-start.md Show resolved Hide resolved
Copy link

@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

Review Status

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between c255389 and d5b6b16.
Files selected for processing (2)
  • docs/en/deployment/quick-start.md (12 hunks)
  • docs/zh/deployment/quick-start.md (12 hunks)
Additional Context Used
Additional comments not posted (10)
docs/zh/deployment/quick-start.md (5)

52-52: The project repository URL has been updated to reflect the rebranding from apollo-build-scripts to apollo-quick-start. This change is crucial for users to download the correct quick start project.


72-72: The inclusion of database-discovery in the SPRING_PROFILES_ACTIVE environment variable is a significant update for enabling database service discovery. This change aligns with the PR's objective to enhance database service discovery capabilities.


78-78: The environment variable settings have been adjusted for database initialization and startup. This change is part of the updates to streamline the setup process for users.


199-199: The update to the image URL for the login page illustration is a valuable improvement for visual guidance. Ensuring that the image URLs are up-to-date enhances the user-friendliness of the documentation.


203-203: The update to the image URL for the home page illustration is another example of the effort to keep the documentation visually engaging and informative. This change contributes to the overall goal of making the quick start guide more accessible and user-friendly.

docs/en/deployment/quick-start.md (5)

52-52: The project repository URL has been updated to reflect the rebranding from apollo-build-scripts to apollo-quick-start. This change is crucial for users to download the correct quick start project.


72-72: The inclusion of database-discovery in the SPRING_PROFILES_ACTIVE environment variable is a significant update for enabling database service discovery. This change aligns with the PR's objective to enhance database service discovery capabilities.


77-77: The environment variable settings have been adjusted for database initialization and startup. This change is part of the updates to streamline the setup process for users.


198-198: The update to the image URL for the login page illustration is a valuable improvement for visual guidance. Ensuring that the image URLs are up-to-date enhances the user-friendliness of the documentation.


202-202: The update to the image URL for the home page illustration is another example of the effort to keep the documentation visually engaging and informative. This change contributes to the overall goal of making the quick start guide more accessible and user-friendly.

docs/zh/deployment/quick-start.md Outdated Show resolved Hide resolved
@nobodyiam nobodyiam merged commit 3d4fa07 into apolloconfig:master Mar 31, 2024
11 of 12 checks passed
@nobodyiam nobodyiam deleted the update-quickstart-doc branch March 31, 2024 05:14
@github-actions github-actions bot locked and limited conversation to collaborators Mar 31, 2024
@nobodyiam nobodyiam added this to the 2.3.0 milestone Apr 3, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
size:L This PR changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant