A web 3D development framework for assembled based on three.js
| 开源 |
## 赞助商
## 主页、案例、文档在线地址
[https://vis-three.github.io](https://vis-three.github.io)
> 文档内容不一定是最新版本内容，持续更新。
## 项目说明
- 本项目使用的是`pnpm`进行项目开发管理，详情请参考:[https://www.pnpm.cn/](https://www.pnpm.cn/)
- [/packages/docs](/packages/docs)为文档仓库。执行`pnpm run build`会自动更新到`website`目录。
- [/packages/examples](/packages/examples)为例子仓库。执行`pnpm run build`会自动更新到`website`目录。
- [/packages/website](/packages/website)为静态页面仓库。执行`pnpm run build`后会更新在线静态站点。
- [/docs](/docs)为本项目的在线静态站点。需要通过`website`更新。
- [/packages/create-vis-three](/packages/create-vis-three)为快速构建模块包的命令工具。
- 其他部分为项目的核心部件和插件库部件。
- 本仓库所有包都可通过`npm`下载。
## 开源说明
- 原生`three.js`开发复杂度太高，需要进行很多细节处理，暂时未发现一种较好的 3D 开发框架不管是在使用上还是在项目业务支持上有较好的效益，故进行相关框架的开源，促进 3D 相关项目更好的发展。
- 发展需要互惠互利，群策群力，特别是对于国内开源市场社区的建立，需要我们根据自身的条件与环境，打造符合我们自己的开源模式，所以请大家丢掉以往的开源惯性思维，集思广益，共同进步。
## 当下开源的问题
1、排除掉公司企业的战略部署，一般的开源项目基本是在利他的初心上建立的，初期项目人员较少，需要有一套得以平衡生活，工作，开源的模式，进而可以细水长流。
2、在当下的社会大环境下，生存压力与发展所衍生出的浮躁与贪婪，影响着每一个人，进而变成生活中各种各样的习惯，打破劣币驱逐良币的规律，需要每一个人的努力。
3、项目中同一个问题会有很多人遇到，但是目前缺少提 issue、查 issue、补 issue 的习惯，所以需要有一套避免重复提问与回答的模式。
4、人是有惰性的，再加上“免费”的开源项目与浮躁急于求成的风气，进而越来越剥夺了人们静下心来思考、理解、感悟的能力，导致没经过思考提炼的内容不断的剥夺大家的精力与时间，所以需要有一套平衡 issue “难易”与 issue 频率的模式。
## 开源流程探索
### 遇到了问题怎么办？
1、首先去历史 issue 中开启全部查找,目前包括 2 个平台:[github](https://github.com/vis-three/vis-three/issues)这样可以避免重复提问。
2、如果没有相关 issue，进行 issue 的新增，请尽量将问题描述详细，包括环境、版本，报错内容，你的疑问点，因为回答者难以站在提问者的环境下思考，所以请提问者尽量站在回答者的角度描述，问题请尽量精确，尽量将范围缩小，范围缩的越小说明你在问题的思考上越深，这样回答者回答起来就越能直入重点。
3、等待开发组进行 issue 的分类。
4、进入赞助、合作、通知群进行 issue 完成度确认。
5、一个 issue 完成后请选择你的回报模式，你可以选择提交 pr 补全问题代码，或者补全项目文档，也可以选择资金赞助的模式，供开发组支持项目的完善。
### 关于 issue 分类
对于所有的 issue，开发组会根据场景分配相关的标签。
开发组罗列以下几个标签作为可付费赞助支持点：
- 新增标签
- 文档标签
- 案例标签
- 提问标签
### 关于付费赞助模式
**开发与赞助额度**：由于不同需求工作量会不同，具体赞助额度可进入**下方 Q 群**中商讨，群内会有赞助标准与讨论空间。
**多人赞助**：如果多人所提 issue 在功能需求上差不多，可进行 issue 与赞助分摊合并，方便大家。
**赞助鸣谢**：赞助后的相关信息会计入上方的赞助名单中公开。
**诚信与公益**：如果您非常需要一个功能，而暂时又无法达成赞助条件，我们可以为您提供帮助，因为我们相信人都是善良与真诚的。如果您提的需求或功能非常的有价值与富有建设性，我们会把它纳入开发核心流程，并不需要赞助费用。
### 模式举例
**支持平台**：[https://space.bilibili.com/3048588](https://space.bilibili.com/3048588)
> 公开平台可以追寻赞助记录，平台抽成当交税与流量支持。
**支持形式**：充电与留言
> 留言请带上仓库名，issue 标题与 ID，如：**【vis-three】#1 文档的配色看起来有点晃眼，能调整下么？**
## 贡献者与开发组
**成为贡献者**：提交您的代码 pr，并通过管理员的代码审核。
**开发收益**：如果您完成了相关的 issue，并且这个 issue 是属于**付费赞助支持**部分的，您将收到此 issue 的**全额赞助费用**，收益模式可根据上方**赞助模式**和**模式举例**进行。
**开发鸣谢**：只要提交并通过代码审核，您就会自动成为贡献者并记录于上方的贡献者名单中。
## 赞助、合作、通知
- QQ 群：586362945
## 前端交流
- QQ 群： 1025827206
## 备注
- gitee 仓库为 github 的同步备份仓库
- github 地址：[https://github.com/vis-three/vis-three](https://github.com/vis-three/vis-three)