docs/home.md

109 lines
6.4 KiB
Markdown
Raw Normal View History

2021-11-09 17:02:57 +08:00
---
title: 首页
2021-11-16 09:24:14 +08:00
description:
2021-11-09 17:02:57 +08:00
published: true
2022-07-21 17:52:17 +08:00
date: 2022-07-21T09:52:15.253Z
2021-11-09 17:02:57 +08:00
tags:
editor: markdown
2022-05-07 17:53:39 +08:00
dateCreated: 2022-03-10T06:06:00.301Z
2021-11-09 17:02:57 +08:00
---
# 首页
欢迎来到openKylin文档平台在这里您将了解到有关openKylin的相关介绍。
# openKylin开源社区
2024-05-06 17:12:45 +08:00
openKylin 社区(以下简称 “社区”)是在开源、自愿、平等和协作的基础上,由各种企业、非营利性组织、社团组织、高等院校、科研机构和个人开发者共同组成的一个开源社区。通过透明而公开的治理,来夯实开源协作开发,成为一个面向全球的开源社区。
2024-05-06 17:12:45 +08:00
openKylin 社区欢迎并鼓励所有人的参与,包括但不限于宣传、协助等,如:
- 宣传:如果您想索取我们的一些文章,或您想把一些新闻放到我们的新闻网页上
- 活动:研讨会与展览会或其他任何型式的聚会活动
- 协助参与SIG兴趣小组共同协作等
联系我们:
- [网站](https://www.openkylin.top/community/)
- [邮箱](contact@openkylin.top)
- [论坛](https://forum.openkylin.top/portal.php)
无论您如何认识自己,也无论他人如何看待您,我们都欢迎您。我们欢迎任何人的贡献,只要与我们社区的交流是积极正面的,目前社区有多种沟通渠道,请参考[社区交流](https://www.openkylin.top/community/community-cn.html),欢迎大家加入社区沟通,营造良好技术氛围。
想要更深入了解社区,请前往:
- [关于我们](./08_%E5%85%B3%E4%BA%8E%E7%A4%BE%E5%8C%BA/%E5%85%B3%E4%BA%8E%E6%88%91%E4%BB%AC.md)
- [社区简介](./08_%E5%85%B3%E4%BA%8E%E7%A4%BE%E5%8C%BA/%E7%A4%BE%E5%8C%BA%E7%AE%80%E4%BB%8B.md)
- [社区组织架构](./08_%E5%85%B3%E4%BA%8E%E7%A4%BE%E5%8C%BA/%E7%A4%BE%E5%8C%BA%E7%BB%84%E7%BB%87%E6%9E%B6%E6%9E%84/%E7%A4%BE%E5%8C%BA%E6%B2%BB%E7%90%86%E7%BB%84%E7%BB%87%E6%9E%B6%E6%9E%84.md)
2022-07-21 17:50:30 +08:00
# openKylin文档平台
2023-03-08 21:27:47 +08:00
负责人docs sig文档兴趣小组
2022-07-21 17:50:30 +08:00
2023-03-08 21:27:47 +08:00
openKylin社区docs sig致力于完善openKylin社区文档帮助用户更好更方便的使用openKylin系统主要工作内容是书写各类说明文档包括但是不限于教程、答疑等内容
2022-07-21 17:50:30 +08:00
## 基本信息
### 仓库地址
主仓库:[docs](https://gitee.com/openkylin/docs)
2024-05-01 00:15:02 +08:00
2022-07-21 17:50:30 +08:00
2023-03-08 21:27:47 +08:00
手机用户因为码云的自适应问题默认看到的是README文件仓库具体内容访问此链接[手机端仓库目录](https://gitee.com/openkylin/docs/tree/master)
2022-07-21 17:50:30 +08:00
### 小组成员
- 陌生人
- chipo
2023-03-20 14:29:03 +08:00
- AICloudOpser
- delong1998
2022-07-21 17:50:30 +08:00
### 通信方式
2023-03-08 20:57:32 +08:00
- 邮件列表:<docs@lists.openkylin.top>[邮件列表订阅页面](https://mailweb.openkylin.top/postorius/lists/docs.lists.openkylin.top/)
2022-07-21 17:50:30 +08:00
## 工作内容
- 收集各种与openKylin有关的问题并根据自己的理解写出对应的解决方法
- 书写各类教程要求都可以在openKylin上使用包括但是不限于教程、答疑等内容
# 文档贡献指南
## 内容要求
- 内容方向没有特殊要求只要可以在openKylin上使用即可
- 内容需要照顾到新手用户,所有的流程都要尽可能详细
- 内容需要有标题、作者和创建时间,其它要求暂无
- 禁止带有侮辱性词汇,禁止政治敏感词汇
- 禁止发布广告
- 禁止发布违反法律法规的信息
- 文件名及分类文件夹尽可能言简意赅
- 结尾统一用.md的后缀编码为统一的无BOM头的UTF-8
2023-03-20 14:29:03 +08:00
- 图片等资源统一放置在和文档同级的资源目录并分类
2022-07-21 17:50:30 +08:00
- 图片高度建议在640px左右、宽度不超过820px、图片一般为.png格式大小不超过150K
- 为避免产权侵犯,引起纠纷,文档配图请使用原创图片或无版权图片
- 图片建议根据内容命名,只用数字序列不利于后续图片的继承
- 禁止任何分支强制推送
- 副仓库禁止推送到主分支主分支不接受除dev分支以外的任何pr请求同时也不接受任何推送
- 主仓库的英文版建议放到en对应的目录sig组成员会有专人去进行审核
- 如果目录有空格则全部用短横线隔开,文件名有空格用下划线隔开
2024-05-01 00:15:02 +08:00
- 如无特殊说明主仓库指的是[docs仓库](https://gitee.com/openkylin/docs)
- 一般情况爱好者写的教程都会放到副仓库官方提供的文档则会放到主仓库但并不绝对sig组也会根据写的内容来做出对应的建议
2023-03-20 14:29:03 +08:00
- 翻译类的文档整篇翻译的不接受轻量级pr只能选择fork以后的pr改动不多的可以接受轻量级pr
- 建议跳转链接在站内使用相对路径除非链接是仓库之外的尽量避免http开头的绝对路径
2022-07-21 17:50:30 +08:00
## 参与方法
- 参与这项工作没有更多的要求,只要愿意尝试且按照指南开展工作,遇到疑问或无法决定的问题时同其他人讨论,就一定可以做出高质量的成果
- sig组成员在仓库上建立对应的分支格式为dev-名字例如dev-moshengrendev-chipo在自己的分支上书写对应的内容
- 非sig成员可以在gitee上fork一下仓库在自己仓库的dev分支进行修改然后按照[内容要求](#内容要求)添加、补充或修改内容完成后通过提pr的方式来提交到主仓库,通过审核后即可合并
2023-03-08 21:27:47 +08:00
- 非sig成员可以通过上述邮件列表<docs@lists.openkylin.top>或单独发送邮件给邮件列表所有者<docs@lists.openkylin.top>沟通来申请加入sig建议先订阅非订阅人员的邮件会被暂时拦截邮件列表订阅连接[docs订阅页面](https://mailweb.openkylin.top/postorius/lists/docs.lists.openkylin.top/)
2023-03-08 21:30:47 +08:00
- [sig申请加入流程](https://docs.openkylin.top/zh/SIG%E7%AE%A1%E7%90%86%E6%8C%87%E5%8D%97/SIG%E7%BB%84%E7%9A%84%E7%94%B3%E8%AF%B7%E4%B8%8E%E6%92%A4%E9%94%80%E6%B5%81%E7%A8%8B)
2022-07-21 17:50:30 +08:00
- 参与贡献前可以先在仓库提一个Issue只限于添加说明想要书写的内容方便查看是否有人正在写自己想写的内容如果想要修改某些内容可以修改以后提pr
- 如果不太会写markdown格式的文档可以在搜索引擎搜索markdown文档语法或者通过邮件列表沟通让sig成员帮忙转换
## 关于许可证
仓库默认使用CC BY-SA 4.0许可证如果有其他需要可以在自己的文档下标明具体的CC许可证版本
以下内容插入文档末尾在文档平台生成页面的时候会自动变成对应的许可证
```
版权声明:本文为<xxx>原创,<xxx>修改,依据 [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) 许可证进行授权,转载请附上出处链接及本声明。
```