finalcut/Contributing.md

3.3 KiB

Contributing

Thank you for your interest in FINAL CUT!

We welcome contributions of all kinds, including patches to code and documentation, bug reports, or just neat feedback. If you ever think that something could be better or different, please give us feedback on it. Do you have problems with FINAL CUT, or are you looking for support in using the library in your project? Feel free to open a new issue if there is not already one on your topic. If you have problems with an application that uses FINAL CUT and have no idea of the cause, please contact the author first.

Github hosts the source code of FINAL CUT. You can make a local copy from the repository using git clone:

> git clone git://github.com/gansm/finalcut.git

Submitting patches

The FINAL CUT project accepts both GitHub pull requests and patches that reach me via other channels. GitHub pull requests are preferred. Please follow our coding style standard.

Explain your work

When submitting a patch, you should include a description of the problem you are trying to solve, how you solved it, and why you chose the solution you implemented. When you submit a bug fix, it is often helpful to include a reproducible description for the problem in your explanation. Important would be instructions on how to test the error and verify its elimination.

Test your code

Run the FINAL CUT unit tests if you have installed CppUnit. Proceed as follows:

The easy way

> make distclean
> ./build.sh unit-test

or

> make distclean
> ./configure --prefix=/usr CXXFLAGS="-g -O0 -DDEBUG -DUNIT_TEST" --with-unit-test
> make test

If you have created uncovered code, I would be very grateful for complementary test code in the existing unit tests.

Issue Tracking

We currently use the issue tracker on Github.

How to help

What FINAL CUT needs

  • We want your feedback, your opinion, your advice, and to hear what you think!
  • Help make FINAL CUT better known. Tell others about this project. A large user base also means a better and more stable codebase.
  • Help maintain and improve the library.
  • Write unit tests for untested code.

What would be helpful

  • Improve documentation:
    Fix typos or grammar mistakes. Revise sections that need improvement or add missing sections.
  • Translations into other languages:
    For many people, reading the documentary in their native language will certainly make getting started with FINAL CUT much easier and more attractive.
  • Better tests:
    High code coverage gives us a stable base that prevents breaking code due to a small patch.
  • Publication in repositories:
    Advocate for the inclusion of FINAL CUT in your preferred distribution.
  • Support for other platforms:
    There are still platforms on which FINAL CUT is not yet executable.
  • Do you like to help other people?
    Answer questions in open issues or help moderate discussion forums or other communication channels.

Please help us make the FINAL CUT widget toolkit the best library for text-based user interfaces.