"Fossies" - the Fresh Open Source Software Archive

Member "cheetah3-3.2.6.post2/docs/developers.rst" (20 Apr 2021, 2403 Bytes) of package /linux/www/cheetah3-3.2.6.post2.tar.gz:

As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

Contributing to Cheetah

Cheetah is the work of many volunteers. If you use Cheetah, share your experiences, tricks, customizations, and frustrations. Please visit https://github.com/CheetahTemplate3/cheetah3 and file bug reports, feature requests or pull requests.

Getting the Code

The Cheetah source code is stored in a central Git repository hosted primarily by GitHub. The primary Git repository can be found here.

Development Process

The typical development workflow for Cheetah revolves around two primary branches maint and next. The next branch is where development planned for the next release of Cheetah is. The maint branch on the otherhand is where backported fixes and patches will be applied for the current release of Cheetah will go, it's common for a patch to be applied to maint and next at the same time.

Anyone and everyone is encouraged to submit patches at any time, but as far as bugs or feature requests go, we try to file those first in the Cheetah3 Bug Tracker and then they can be organized into particular releases as is necessary.

In addition to the bug tracker, Cheetah uses Travis CI for automating builds and test runs (see: Cheetah at Travis).

Prior to the tarballing of a release, all tests must be passing before the next branch is merged down to the Git master branch where the release tarball will actually be created from.

Filing Bugs

No software is perfect, and unfortunately no bug report is either. If you've found yourself faced with a bug in Cheetah, or just have a good idea for a new feature, we kindly ask that you create an issue in the Cheetah3 Bug Tracker.

Some tips for filing a useful bug report, try to include the following: