Skip to content

diagrams/diagrams-contrib

Repository files navigation

Build Status

This package is a repository for user contributions to the diagrams project: generation of specialized diagrams, fun or instructive examples, half-baked ideas, stuff which is not sufficiently polished or general to go in the diagrams-lib package but is nonetheless worth sharing. Any code is welcome, as long as it conforms to a few simple standards:

  • Code must be released under a BSD3 license (see the LICENSE).

  • You must list yourself as the maintainer.

  • Try to keep external dependencies to a minimum; the goal is for diagrams-contrib to be easily installable by as many people as possible. New dependencies will be considered on a case-by-case basis. Dependencies involving the FFI will most likely be rejected. If you have some cool code using diagrams which requires big external dependencies, you should release it as a separate package rather than including it in diagrams-contrib.

  • There should at minimum be a Haddock comment on the module itself, explaining the purpose, giving some examples of use, etc. You may also want to use diagrams-haddock to include some example images in the Haddock documentation; see the diagrams-haddock documentation and take a look at other modules in the package for examples.

  • It must compile with no warnings under -Wall. This may seem a bit draconian, but you'll get over it. If it makes you feel any better, you are welcome to turn off specific warnings for your module with an {-# OPTIONS_GHC -fno-warn-blah #-} pragma.

For more general information on contributing to the diagrams project, see the Contributing page on the diagrams wiki.