Documents Contribute Guide
If you want to help contribute shardingsphere documents or websites, we are happy to help you! Anyone can contribute, whether you’re new to a project or have been using shardingsphere for a long time, whether you’re a self identified developer, end-user, or someone who can’t stand typos,can contribute to documents or websites. In the contributor guide, we have mentioned how to submit Issues and pull request. here we will introduce how to submit pull request to document.
Precondition
- Familiar with Official website.
- Familiar with Collaborating with issues and pull requests.
- Familiar with Markdown.
- Familiar with Hugo.
Fork document
Fork the master branch of ShardingSphere.
Directory structure description
docs
├─document
│ ├─content
│ └─static
├─community
│ ├─content
│ └─static
└─blog
├─content
└─staticDocument Basics
ShardingSphere documentation is written in Markdown and generated with Hugo.
The Markdown sources and article media are maintained in the docs directory, and the generated website is deployed to the asf-site branch of shardingsphere-doc.
- Latest version Official course source is stored in
docs/document/content/. - Community introduction and contribution related document sources are stored in
docs/community/content/. - Blog article sources are stored in
docs/blog/content/.
Article media is stored in each site’s static directory.
You can submit questions, edit content, and view other people’s changes from Github.
Page template
Website templates and build configuration are maintained in shardingsphere-doc.
Ask specific and searchable questions
Anyone with a GitHub account can ask questions (error reports) about shardingsphere documents. If you find an error, ask questions even if you don’t know how to fix it.
How to ask questions?
- Attach the problem document link.
- Describe the problem in detail.
- Describe the problems caused to users.
- Propose the repair method.
- In Issues,
New issueasks your question.
Submission changes
Operation steps:
- Locate the file you want to operate in the master branch directory structure.
- After the file operation is completed, pull request is raised to the master branch.
Appointment
- Use the Hugo version specified in the website build workflow in
shardingsphere-doc. - asf-site branches are updated by the official on a regular basis, you do not need to submit pull request to asf-site.