mirror of https://gitee.com/openkylin/docs.git
Gitee
commit
15c60e73d6
132
en/home.md
132
en/home.md
|
|
@ -8,5 +8,133 @@ editor: markdown
|
|||
dateCreated: 2022-03-10T06:04:02.696Z
|
||||
---
|
||||
|
||||
# index
|
||||
Welcome to the openKylin community
|
||||
# First
|
||||
Welcome to the openKylin Documentation Platform, Here you will find comprehensive resources about openKylin.
|
||||
|
||||
# openKylin Community
|
||||
|
||||
The openKylin Community (hereinafter referred to as "the Community") is a global open-source community jointly established by enterprises, non-profit organizations, associations, academic institutions, research institutes, and individual developers. Founded on principles of openness, voluntariness, equality, and collaboration, the Community adopts transparent and open governance to strengthen open-source collaborative development.
|
||||
|
||||
Participation & Contribution
|
||||
openKylin welcomes and encourages participation from everyone, including but not limited to:
|
||||
- Information Dissemination: Request our articles or share news on our platform.
|
||||
- Events: Co-organize seminars, exhibitions, or gatherings.
|
||||
- Collaboration: Join SIGs (Special Interest Groups) for co-development.
|
||||
|
||||
Contact Us
|
||||
- [Website](https://www.openkylin.top/index-en.html)
|
||||
- [contact@openkylin.top](<contact@openkylin.top>)
|
||||
- [Forum](https://bbs.openkylin.top/)
|
||||
|
||||
We welcome contributions through multiple channels. For all communication methods, see:[Community Communication](https://www.openkylin.top/community/community-cn.html)，Join us to foster a positive technical ecosystem!
|
||||
|
||||
Explore Further：
|
||||
- [About Us](./07_关于社区/关于我们.md)
|
||||
- [Community Overview](./07_关于社区/社区简介.md)
|
||||
- [Governance Structure](./07_关于社区/社区组织架构/社区治理组织架构.md)
|
||||
|
||||
# openKylin Documentation Platform
|
||||
Responsible Team: docs SIG (Documentation Special Interest Group)
|
||||
|
||||
The openKylin Community docs SIG is dedicated to improving community documentation, helping users better utilize the openKylin system. Our primary work involves creating various documentation types, including but not limited to tutorials and troubleshooting guides.
|
||||
|
||||
## Basic Information
|
||||
|
||||
### Repository Addresses
|
||||
|
||||
[Main Documentation Repository](https://gitee.com/openkylin/docs)
|
||||
|
||||
[FAQ Documentation Standards](./04_社区贡献/FAQ文档贡献指南.md)
|
||||
|
||||
|
||||
Mobile Users Note: Due to Gitee's responsive limitations, mobile devices default to the README file. Access full repository content at: [Mobile Repository Directory](https://gitee.com/openkylin/docs/tree/master)
|
||||
|
||||
### Core Team Members
|
||||
|
||||
- 陌生人
|
||||
- chipo
|
||||
- AICloudOpser
|
||||
- delong1998
|
||||
|
||||
### Communication Channels
|
||||
|
||||
- Mailing List: [<docs@lists.openkylin.top>](https://mailweb.openkylin.top/postorius/lists/docs.lists.openkylin.top/)
|
||||
|
||||
## Scope of Work
|
||||
|
||||
- Collect openKylin-related issues and document verified solutions
|
||||
- Create practical tutorials applicable to openKylin environment
|
||||
- Develop troubleshooting guides and technical documentation
|
||||
|
||||
# Documentation Contribution Guidelines
|
||||
## Content Requirements
|
||||
Writing Standards
|
||||
- Maintain clarity and simplicity; use technical terms only when necessary
|
||||
- User-focused documentation should prioritize practical scenarios and solutions
|
||||
- Ensure technical accuracy without exaggeration or misleading statements
|
||||
- Focus on stable, tested methodologies; avoid deprecated technologies
|
||||
- Exclude personal information, proprietary content, or legally restricted material
|
||||
- Accommodate novice users with detailed step-by-step procedures
|
||||
- Include title, author, and creation date in all documents
|
||||
- Prohibit offensive language, politically sensitive terms, advertisements, or illegal content
|
||||
|
||||
Technical Specifications
|
||||
- File Management:
|
||||
- Use concise file/folder names with underscore separators (e.g., Community_Structure.md)
|
||||
- Apply .md extension with UTF-8 encoding (without BOM header)
|
||||
- Media Assets:
|
||||
- Store images in categorized directories adjacent to documents
|
||||
- Optimal dimensions: ≤820px width, ≈640px height (≤150KB .png format)
|
||||
- Use original or royalty-free images to prevent copyright issues
|
||||
- Employ descriptive naming (avoid numerical sequences)
|
||||
- Linking:
|
||||
- Prefer relative paths for internal repository links
|
||||
- Minimize absolute HTTP paths unless referencing external resources
|
||||
|
||||
Repository Protocols
|
||||
- Branch Management:
|
||||
- SIG members: Use dev-<name> branches (e.g., dev-moshengren)
|
||||
- Non-SIG contributors: Fork repository → modify in dev branch → submit PR
|
||||
- Main Branch Rules:
|
||||
- master branch accepts PRs only from dev branches
|
||||
- Direct pushes to master prohibited
|
||||
- Translation Workflow:
|
||||
- Place English translations in /en/ directories
|
||||
- Full translations require forked repository PRs (no lightweight PRs)
|
||||
- Minor translation edits may use lightweight PRs
|
||||
|
||||
|
||||
## Contribution Process
|
||||
|
||||
Participation Methods
|
||||
1. SIG Members:
|
||||
- Create feature branches following dev-<name> convention
|
||||
- Submit changes via pull requests after local development
|
||||
|
||||
2. External Contributors:
|
||||
- Fork repository → modify in dev branch → submit PR
|
||||
- Pre-submission checks:
|
||||
- Verify compliance with [Content Requirements](#Content Requirements)
|
||||
- Check for existing work via Issues
|
||||
|
||||
3. Joining SIG:
|
||||
- Apply through mailing list: [docs@lists.openkylin.top](https://mailweb.openkylin.top/postorius/lists/docs.lists.openkylin.top/)
|
||||
- Required: Subscribe to mailing list first
|
||||
- Follow [SIG Application Procedure](./07_关于社区/SIG管理指南/SIG组的申请与撤销流程)
|
||||
|
||||
Support Resources
|
||||
- Markdown assistance available via mailing list
|
||||
- SIG members provide format conversion support
|
||||
- Propose new topics through Issue tickets
|
||||
|
||||
## Licensing Information
|
||||
|
||||
All documentation defaults to CC BY-SA 4.0 license. Alternate CC licenses may be specified per document.
|
||||
|
||||
Include this copyright notice at document end:
|
||||
```
|
||||
Copyright Notice: Originally authored by <Author>, modified by <Contributor>.
|
||||
Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
|
||||
Redistribution requires attribution and link to source material.
|
||||
|
||||
```
|
||||
Loading…
Reference in New Issue