贡献指南

欢迎来到 PrimeVue 贡献指南，感谢您考虑做出贡献。

简介 #

PrimeVue 是一个流行的 Vue UI 库，由 PrimeTek 维护，该公司以其为各种框架提供的全面 UI 组件集而闻名。PrimeTek 致力于提供高质量、多功能和可访问的 UI 组件，以帮助开发人员更快地构建更好的应用程序。

开发设置

首先，从 GitHub 克隆 PrimeVue 存储库


git clone https://github.com/primefaces/primevue.git
cd primevue

然后在本地环境中的http://localhost:3000/运行展示。


npm run setup
npm run dev

项目结构

PrimeVue 使用单体存储库架构，库位于packages文件夹中，网站位于apps/showcase中。


- apps
  - showcase                // website
- packages
  - auto-import-resolver    // unplugin resolver
  - core                    // core api
  - icons                   // primeicons as sfc
  - metadata                // list of components and directives
  - nuxt-module             // module for nuxt    
  - primevue                // main package of components and directives
  - themes                  // presets of styled mode

需要帮助 #

PrimeVue 是一个由社区驱动的项目，由 PrimeTek 的专业知识和赞助支持，我们感谢您提供的任何帮助。以下是一些您可以做出贡献的领域

问题分类

通过以下方式帮助我们管理问题：

重现报告的错误
澄清问题描述
使用适当的标签标记问题

发送拉取请求

我们鼓励您发送拉取请求，特别是对于标记为help-needed标签的问题。

社区支持

通过参与问题跟踪器、GitHub 讨论和PrimeLand Discord服务器来帮助其他用户。您的专业知识可以帮助其他人解决问题，并改善他们使用 PrimeVue 的体验。

关键点 #

PrimeVue 有几个附加组件，如 UI 套件、高级模板和模块，它们依赖于设计令牌和样式。任何核心结构更改，如添加新属性、事件或更新设计令牌，都应与核心团队沟通，以确保一致性和兼容性。

沟通 #

加入PrimeLand Discord服务器上的贡献者频道，与 PrimeVue 工作人员和其他贡献者联系。在这个频道中，您可以讨论您想要贡献的领域并接收反馈。这个频道对所有想要贡献的人开放。

途径 #

PrimeTek 提供了一个涉及贡献者和核心团队的组织结构

贡献者角色

在频繁贡献一段时间后，社区成员将被授予贡献者角色。平均而言，可能需要大约三个月，但确切的持续时间可能会因个人承诺而异。

提交者角色

如果贡献者积极参与代码库和 PR，他们的角色可能会升级到提交者级别，从而提供对 PrimeVue 代码库的直接提交访问权限。

就业

PrimeTek 更倾向于从开源提交者中聘用团队成员，因此当有职位空缺时，您可能会获得全职职位。

益处 #

为 PrimeVue 做贡献会带来一些好处。成为开源项目的一部分将增强您的职业生涯并开启令人兴奋的机会。贡献者和提交者将列在我们的团队页面上。您将在开发者社区中获得显著的知名度，同时提升自己的专业水平。

您将被邀请到 Discord 上的私人通信频道，与 PrimeTek 联系。此外，贡献者可以免费访问所有 PrimeVue 附加组件，如高级模板、模块和 UI 套件。

CLA #

当社区成员被授予贡献者角色时，他们需要签署一份贡献者许可协议 (CLA) 以用于法律目的。这有助于保护贡献者和 PrimeTek。