Difference between revisions of "Diagrams/Dev"
< Diagrams
Jump to navigation
Jump to search
m (→Design notes: link to bounding function notes) |
(link to new page on release automation) |
||
| (29 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | == Guidelines == |
||
| + | |||
| + | * [[Diagrams/Contributing|How to contribute]] |
||
| + | |||
| + | * [https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md Coding style guidelines]. It's not worth being super picky about these, but in general they are quite good. |
||
| + | |||
| + | * [http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html git commit message guidelines]. |
||
| + | |||
| + | * [[/ReviewingAndMerging|Guidelines for reviewing and merging code]]. For those with push access to one or more repos in the [http://github.com/diagrams github diagrams organization]. |
||
| + | |||
== Design notes == |
== Design notes == |
||
* [[/Text|Text support]] |
* [[/Text|Text support]] |
||
* [[/Paths|Notes on extending support for paths]] |
* [[/Paths|Notes on extending support for paths]] |
||
| − | * [[ |
+ | * [[/Bounds|Bounding functions]] |
| + | * [[/Transformations|Notes on the representation of transformations: linear and affine transformations, inverse, transpose, etc.]] |
||
| + | * [[/Arrows|Arrows]] |
||
| + | * [[/Gradients|Gradients]] |
||
| + | * [[/Expression|Backend type parameters and the expression problem]] |
||
| + | * [[/Fixpoint|Fixpoint semantics]] |
||
| + | * [[/Constraints|Constraint design notes]] |
||
| + | * [[/AlignedCompose|Aligned composition]] |
||
| + | |||
| + | === Outdated design notes === |
||
| + | |||
| + | Stuff which is no longer current but kept here for historical reference. |
||
| + | |||
| + | * [[/Freezing|Freeze, attribute transformation, and the backend API]] (after the merging of the "units" branch, freeze is no more) |
||
| + | |||
| + | == Links/resources == |
||
| + | |||
| + | Links to software, papers, documentation, etc. which is helpful or relevant. |
||
| + | |||
| + | * [http://cairographics.org/manual/ cairo reference manual] |
||
| + | |||
| + | * [http://potrace.sourceforge.net/ potrace], a nice raster -> vector library. Even has a [http://potrace.sourceforge.net/potrace.pdf detailed description of the algorithms used]. |
||
| + | * [http://homepages.cwi.nl/~ploeg/papers/padl131.pdf A Library for Declarative Resolution-Independent 2D Graphics] (PADL 2013) |
||
| + | * [http://conal.net/Pan/papers.htm Pan (Conal Elliott)] |
||
| + | |||
| + | Misc instructions |
||
| + | |||
| + | * How to add [[/IRCHooks|IRC Hooks]] to repositories in the github diagrams organization |
||
| + | |||
| + | == Releases == |
||
| + | |||
| + | * [[/Migrate0.6|0.5 to 0.6 migration]] |
||
| + | * [[/Migrate0.7|0.6 to 0.7 migration]] |
||
| + | * [[/Migrate1.0|0.7 to 1.0 migration]] |
||
| + | |||
| + | == Miscellaneous links == |
||
| + | |||
| + | * [http://hackage.haskell.org/trac/ghc/ticket/4921]: ticket re: GHC error messages with ambiguous type variables. This comes up a lot when using diagrams, it would be nice to see this ticket resolved. |
||
| + | |||
| + | * [[/BuildStatus|travis-ci build status]] of all diagrams packages. |
||
| + | |||
| + | * byorgey's time spent hacking on diagrams: |
||
| + | <p>[https://www.beeminder.com/byorgey/goals/diagrams http://beeminder.com/byorgey/diagrams-thumb.png]</p> |
||
| + | |||
| + | * [[/ReleaseAutomation| Notes on automating tedious parts of our release process]] |
||
Revision as of 15:50, 22 June 2015
Guidelines
- Coding style guidelines. It's not worth being super picky about these, but in general they are quite good.
- Guidelines for reviewing and merging code. For those with push access to one or more repos in the github diagrams organization.
Design notes
- Text support
- Notes on extending support for paths
- Bounding functions
- Notes on the representation of transformations: linear and affine transformations, inverse, transpose, etc.
- Arrows
- Gradients
- Backend type parameters and the expression problem
- Fixpoint semantics
- Constraint design notes
- Aligned composition
Outdated design notes
Stuff which is no longer current but kept here for historical reference.
- Freeze, attribute transformation, and the backend API (after the merging of the "units" branch, freeze is no more)
Links/resources
Links to software, papers, documentation, etc. which is helpful or relevant.
- potrace, a nice raster -> vector library. Even has a detailed description of the algorithms used.
- A Library for Declarative Resolution-Independent 2D Graphics (PADL 2013)
- Pan (Conal Elliott)
Misc instructions
- How to add IRC Hooks to repositories in the github diagrams organization
Releases
Miscellaneous links
- [1]: ticket re: GHC error messages with ambiguous type variables. This comes up a lot when using diagrams, it would be nice to see this ticket resolved.
- travis-ci build status of all diagrams packages.
- byorgey's time spent hacking on diagrams:
