Archive:Policies (zh CN)

From KDE TechBase
Revision as of 16:07, 23 June 2013 by AnneW (talk | contribs) (AnneW moved page Policies (zh CN) to Archive:Policies (zh CN) without leaving a redirect: Obsolete)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

KDE开发者固守着一些成文或不成文的规则。下面的文档就总结了这些规则,但这并不是完全的。如果您想参与构建这些规则,或者参与讨论他们,请使用kde-policies邮件组。该邮件组就是为了这个目的而创建的。

开发者准则

下列准则适用于所有的KDE开发者,并且,希望所有拥有KDE SVN帐号的人都能遵守这些准则。SVN 的commit 准则是最为重要的。开发库函数(主要是kdelibs,当然SVN的核心库函数的开发当属此列)的人应该阅读库函数文档准则(还有apidox howto文档).

SVN Commit Policy
保证KDE SVN能正常工作。有三条黄金定律(确保能编译,遵从既有代码风格,使用描述性的日志消息),以及其他18条规则。他们使得您的SVN贡献能够最好的发挥作用。
Application Life Cycle
了解KDE程序的生命周期。了解如何上载程序,如何获得者主要KDE模块,以及在放弃维护您的程序需该做些什么。
Licensing Policy
KDE SVN中的文件不能随意的授权。这条准则规定了在软件仓库中什么是可以做的。简而言之: 对库函数使用LGPL协议,对其他东西使用GPL或BSD协议。
Library Documentation Policy
(重)使用库需要做文档说明。这条准则解释了为什么以及如何做文档,以及需要遵从的风格。apidox howto 含有更多为库函数写文档的技术信息。
Library Code Policy
KDE库的API及代码需要遵从此准则所给出的公约。
Kdelibs Coding Style
这份文档描述了kdelibs的推荐代码风格。这种风格并不是硬性要求的,但要保证代码格式的一致性,还是推荐这种风格。
Adding New Classes to kdelibs
如何给kdelibs加入新类或新库的建议。
CMake Coding Style
这份文档描述了在KDE下使用CMake的编程风格。
CMake and Source Compatibility
使得未来发布的KDE能CMake兼容。
CMake Commit Policies
考虑改变CMake构建系统是说需要遵从的准则。
Binary Compatibility Issues With C++ (Original)
A quick overview of issues with binary compatibility with C++. Keep this in mind while altering the API of kdelibs.
URI & XML Namespaces Policy
Sometimes KDE technologies and applications needs URIs, such as for XML formats. This policy describes practices for that, and how to allocate URIs.
API to Avoid
There are classes and functions in Qt or other places that should be avoided by KDE applications.

Procedures

Whereas policies are normative for individual developers -- that is, they describe how developers must behave -- procedures describe how 'the KDE project' as a whole has chosen to behave. We describe what we will do under certain circumstances and why.

Security Policy
How security problems can be reported to [email protected] and how the security team responds to security issues.
Packaging Policy
This describes KDE's viewpoint on binary packages and elaborates the statement 'KDE provides source.'