CONTRIBUTING.adoc

Contributing

Table of Contents

• License Agreement
• Submitting an Issue
• Submitting a Pull Request
  • Background Knowledge
  • Writing and Executing Tests
  • Running Feel++ in Development Mode
• Supporting Feel++ on supercomputers

License Agreement

By contributing changes to this repository, you agree to license your contributions under the LGPL or GPL license. This ensures your contributions have the same license as the project and that the community is free to use your contributions. You also assert that you are the original author of the work that you are contributing and that any change to your work will have to be contributed back to the community.

Submitting an Issue

We use the issue tracker on GitHub associated with this project to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn’t already been submitted. When submitting a bug report, please include a Gist that includes any details that may help reproduce the bug, including your C++ compiler and operating system.

Most importantly, since Feel++ provides a DSEL based on the embedded Galerkin type language, provide as short as possible testcase to replicate the issue and using the Feel++ mathematical concepts.

An ideal bug report would include a pull request with failing specs.

Submitting a Pull Request

1. Fork the repository.

📎	missing bits here, documentation pending

If your tests pass, return to step 4.

1. Implement your feature or bug fix.

2. Run ctest to run the tests. If your tests fail, return to step 1.

3. Add documentation for your feature or bug fix.

4. If your changes are not 100% documented, go back to step 3.

5. Add, commit, and push your changes.

6. Submit a pull request.

For ideas about how to use pull requests, see the post Useful GitHub Patterns.

Background Knowledge

As Feel++ is built using C++, it requires some knowledge about C++ and some libraries and tools it uses such as Boost, PETSc or Gmsh. The following resources provide a good starting point for contributors who may not be completely comfortable with these tools:

• The Mathematics of Feel++ provides the mathematical background of Feel++ and in particular the

  • Feel++ Finite Element manual

• Gmsh Web site provides a lot of information regarding Gmsh and in particular

  • An extensive Documentation

  • A Tutorial

  • Screencasts showing how to use the graphical user interface

• PETSc Web site provides a lot of material regarding PETSc (pronounced PET-see) which is the main library Feel++ use for solving (non-)linear systems

  • An extensive Documentation

  • Tutorials

While these resources don’t cover everything needed they serve as a good starting off point for beginners.

Writing and Executing Tests

Feel++ provides a large testsuite.

📎	Documentation pending

Running Feel++ in Development Mode

📎	Documentation pending. Feel++ is designed so that you can run in Debug mode.

Supporting Feel++ on supercomputers