核心团队工作流程

关于本指南

本指南介绍了我们如何改变Matomo(以前Piwik)核心,运作以及别人如何参与我们的工作的开发者团队。

如果是阅读本指南

  • 你想知道吗核心团队如何工作
  • 你想知道吗如何进入核心团队
  • 你想知道吗如何提交错误报告或功能请求
  • 你想知道吗如何通过提交拉动请求参加核心开发

指导假设

本指南不作任何假设。您无需知道如何编写代码或了解Matomo的工作原理即可理解本指南。

我们如何管理我们的工作

我们用GitHub.跟踪与Matomo、网站和Matomo文档相关的所有bug、功能请求和任务。

我们确保所有门票包含足够的信息,包括:

  • 如果是bug,请提供有关如何复制它的详细信息,
  • 如果是一个新功能,请用建议或规范解释用例,
  • 如果有UI改进,请提供实体模型或更改的详细说明。

我们相当沉迷于保持我们的问题跟踪器一个有组织的地方。门票是“错误”,'增强'或“任务”。开发人员(Matomo团队成员或外部贡献者)决定自己想要工作的功能,优先考虑下一个版本的里程碑问题。我们一直在使用问题跟踪器项目的开始.

我们如何组织问题

里程碑

所有打开的车票都分组在里程碑。单击菜单链接“里程碑”在GitHub问题中。版本里程碑列在最顶部,包含所有最重要的问题,以根据我们对Matomo Analytics亚博ap下载平台的愿景.

最重要的问题和bug被转移到短期里程碑。此里程碑是我们的活动票证积压。我们不时从中移动一张票证短期到当前版本里程碑(例如。Matomo 3.0.0.)。

我们尚未计划的其他建议、任务和功能请求将移至中期或者长期里程碑。

标签

最重要的标签标记为问题:隐私,安全,表现,测试与质量保证,可用性,平台,市场网站piwik.org..

其他重要标签用于危急主要的问题。新开发人员可以通过对轻松挑选问题。

我们如何发布新版本

频繁发布

我们试图发布一个新的Matomo版本大约一个月一次.当满足以下发布条件时,发布已准备好:

一般来说,我们将释放几个测试版,以便提前获得和确保Matomo的连续测试。

要发布新的Matomo版本,发布管理器将用git标记新版本(请参阅所有释放标签)。然后运行shell脚本以生成归档(zip和tar.gz)加密签名然后复制到生成服务器builds.piwik.org.builds.piwik.org/ltest.更新了最新的稳定版本号。几小时内,Matomo安装将通过用户更新一下升级机制–或通过手动升级。

包含字符串“Alpha”,“Beta”,“RC”的版本是为测试目的而构建的,并且不会宣传piwik.org.但是,它们可以在构建服务器上提供builds.piwik.org/LATEST_BETA已更新以包含版本字符串。如果要测试最新功能,可以启用Matomo自动使用最新的Beta版(看到这个常见问题解答学习如何)。

更改兴

这个更改兴然后使用此版本的新条目更新。更改日志通常列出此版本中关闭的所有票证,并将人们指向最新版本常见问题用户指南.

我们如何管理源代码

Matomo git存储库位于GitHub.并公开访问https://github.com/matomo-org/matomo.

截至2014年,我们管理Github上有超过40个存储库.这包括该Matomo的主存储库和几个插件,主题和工具集最为出色的Matomo,如Matomo客户在Python,Ruby,C#,SDKS for iOS,Debian软件包和其他有用的Matomo开发人员工具。

Git所有者

来自Matomo组织的所有开发人员都可以推送到所有git存储库。

Git提交过程

提交给Git的所有代码由团队中的至少一个其他开发人员进行审核。非常经常,Matomo开发人员本身将通过拉动请求进行更大的变化进行审核。外部开发人员提交的所有拉拔请求或补丁都会被广泛审查。

强烈建议在主分支(*.x-dev)尊重Matomo编码标准,不会导致测试失败,并且不会在UI或平台中创建回归。提交消息应在几乎所有情况下引用票号;例如,

修复#159  - 更改了修补程序修补程序以使用wrapinner()而不是wrap()

此消息将自动关闭票证#472.您也可以简单地使用#159并将评论自动添加到票号#159,并将其链接到GitHub上的提交。

如适用,相关在线文档以及相关的常见问题应该更新。

Git存储库推送访问

要获得对Matomo代码存储库的推式访问,必须在项目中进行积极的更改,例如贡献拉取请求,带来新的想法、代码、营销、产品愿景。当完成一定数量的工作后,当我们相信您的技能和判断力时,我们将邀请您加入我们的核心团队.

与核心团队联系

在论坛上

加入我们在Forum.Piwik.org.

探索我们充满活力的社区,分享分析技巧、如何充分利用Matomo的建议或一般问题。一些团队成员以及社区的活跃成员定期访问论坛。

通过电子邮件

您可以通过电子邮件与团队联系:你好(at)piwik.org,或使用联系方式.

使用IRC

一些团队成员可在IRC中找到,网址为irc.freenode.net/#piwik.(网络帽)。

影响Matomo开发

有很多方法可以在项目中产生差异并影响Matomo的整体善良,其中大部分不包括编码。

评论现有问题

如果您发现一个新的功能请求非常令人兴奋或重要,或者您遇到了一个特定的bug,那么Matomo团队听到的最好方式就是对问题进行评论。请求最多的功能通常在优先级列表中处于较高的位置。

提交错误报告

帮助核心开发的一种方法是在找到错误时提交报告。

如果您认为在Matomo中发现了bug,请执行以下操作:

  • 确保您使用的是最新版本马托莫释放
  • 搜索论坛,常问问题问题跟踪器如果已经报告了类似或相同的错误。
  • 如果您的bug看起来是新的,请尝试确定复制它的步骤。
  • 如果您准备报告错误,请注册一个帐户在问题跟踪器中,登入及创建新票证
  • 确保标题和描述尽可能具有描述性和清晰性。问题对您来说是新问题,还是总是失败?如果您给出清晰的描述,您将帮助开发人员尝试重现和修复问题。
  • 在机票中,有关如何重现错误的发布说明,如果适用,则添加数据集,屏幕截图。还包括有关配置的相关部分的详细信息(浏览器,操作系统,PHP版本等)。

提交功能请求

任何人都可以通过提交功能请求来贡献Matomo。您可以与其他用户讨论在Matomo中可以改进的内容特征建议论坛,或搜索以前是否有人在马托莫问题追踪器.如果找到现有问题,请发表评论以使您的声音听到。除此以外创建一个新问题描述如何改进Matomo以帮助您在日常工作中(理想情况下解释为什么这很重要,它会为您解决的问题,也许有些关于如何完成的建议)。

为matomo做出贡献

贡献代码

如果您可以编写代码并希望直接帮助Matomo开发,您可以贡献更改!阅读我们的为matomo核心做出贡献学习更多指南。

其他贡献方式!

还有其他有用的方法可以参与Matomo并产生积极的差异!了解更多:我如何参与?