My group uses Literate Programming for most of our source code---this means that internal documentation is written using LaTeX. We have been using PStricks for fancy technical diagrams of the system, but have recently been recommended to use TikZ. I've gathered this information:
- TikZ/PGF is new and maintained; PStricks went a long time without a maintainer but has received some maintenance in the last couple of years.
- TikZ works with many back ends, including (for those who care)
pdftex
. PStricks works only withdvips
. - PStricks is more powerful and expressive than TikZ. In a dire emergency you even have the full power of PostScript.
- PStricks has a significant ecology of extra packages that have been built on top of it; TikZ is too new to have many such things.
- TikZ claims to have been designed "with the shortcomings of PStricks in mind." The author does not specify which shortcomings.
I'm interested in the answers to two questions. If you wish, feel free to post one answer per question:
What is the learning curve like for the two tools? (I consider PStricks to have a steep learning curve; about TikZ I am uninformed.)
Considered as programming APIs, is one of these two packages significantly better designed than the other? If so, which is the better design, and why? (What properties does it have that make you consider it better?)
To make a compelling argument why one API is better than another, you may want to resort to examples.