Skip to content

docs: add Maven mirror config and troubleshooting guide for China developers#233

Open
XiaoSeS wants to merge 1 commit intomainfrom
docs/maven-mirror-china-guide
Open

docs: add Maven mirror config and troubleshooting guide for China developers#233
XiaoSeS wants to merge 1 commit intomainfrom
docs/maven-mirror-china-guide

Conversation

@XiaoSeS
Copy link
Copy Markdown
Collaborator

@XiaoSeS XiaoSeS commented Apr 3, 2026

Summary

  • Add Aliyun mirror config in server/.mvn/settings.xml for Maven dependency downloads
  • Update maven-wrapper.properties to use Aliyun mirror for downloading Maven distribution
  • Add detailed error messages in Makefile when backend startup fails
  • Add troubleshooting section in quickstart.md for China developers
  • Add FAQ entry for local development startup issues
  • Update README with link to local development guide

Changes

File Change
server/.mvn/settings.xml New file - Aliyun mirror configuration
server/.mvn/wrapper/maven-wrapper.properties Use Aliyun mirror for Maven distribution
Makefile Add detailed error hints when backend fails to start
docs/skillhub/quickstart.md Add troubleshooting section for China developers
docs/skillhub/faq.md Add FAQ for local development startup issues
docs/skillhub/en/quickstart.md English version
docs/skillhub/en/faq.md English version
README.md Add link to local development guide
README_zh.md Add link to local development guide

Test plan

  • Verify server/.mvn/settings.xml is valid Maven settings
  • Verify maven-wrapper.properties URL is accessible
  • Verify Makefile error messages display correctly
  • Verify documentation renders correctly on GitHub Pages

…elopers

- Add Aliyun mirror config in server/.mvn/settings.xml
- Update maven-wrapper.properties to use Aliyun mirror for Maven distribution
- Add detailed error messages in Makefile when backend startup fails
- Add troubleshooting section in quickstart.md for China developers
- Add FAQ entry for local development startup issues
- Update README with link to local development guide
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