tintin: A softer alternative to Haddock

[ apache, documentation, library, program ] [ Propose Tags ] [ Report a vulnerability ]

Please see the website https://theam.github.io/tintin

[Skip to Readme]

Modules

[Last Documentation]

Tintin
- Tintin.Capabilities
  - Tintin.Capabilities.Filesystem
  - Tintin.Capabilities.Logging
  - Tintin.Capabilities.Process
- Tintin.ConfigurationLoading
- Tintin.Core
- Tintin.Domain
  - Tintin.Domain.DocumentationFile
  - Tintin.Domain.FrontMatter
  - Tintin.Domain.HtmlFile
  - Tintin.Domain.Project
- Tintin.Errors
- Html
  - Tintin.Html.Style
  - Tintin.Html.Templating
- Tintin.Parse
- Tintin.Render

Downloads

tintin-1.7.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

NickSeagull

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	1.0.3, 1.0.4, 1.2.4, 1.2.5, 1.3.5, 1.4.5, 1.4.6, 1.5.0, 1.7.0, 1.7.1, 1.8.0, 1.9.0, 1.9.1, 1.9.2, 1.9.4, 1.9.5, 1.10.0, 1.10.1
Change log	ChangeLog.md
Dependencies	base (>=4.7 && <5), clay, data-has, directory, frontmatter, inliterate, lucid, optparse-generic, process, require, temporary, text, tintin, universum, yaml [details]
License	Apache-2.0
Copyright	2018 Theam
Author	The Agile Monkeys
Maintainer	hackers@theam.io
Uploaded	by NickSeagull at 2018-05-30T14:59:53Z
Category	Documentation
Home page	https://github.com/theam/tintin#readme
Bug tracker	https://github.com/theam/tintin/issues
Source repo	head: git clone https://github.com/theam/tintin
Executables	tintin
Downloads	8809 total (26 in the last 30 days)
Rating	2.0 (votes: 1) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] All reported builds failed as of 2018-05-30 [all 3 reports]

Readme for tintin-1.7.0

[back to package description]

Tintin

Tintin allows you to create fancy plug 'n' play documentation sites for your Haskell project very easily.

Proceed to site to learn how to use Tintin.

FAQ

Why not just use Haddock?

Haddock provides a great interface for writing API documentation, which is a kind of hard documentation. Newcomers from other languages are used to have a website per library, but sometimes this gets uncomfortable, as maintaining a documentation website is more work for the author.

Tintin helps with this problem, as you get styling and organization for free. You just have to write your documentation using Markdown.

The website generation is focused towards guides and tutorials, helping your users understand how to use your package easily.

Why not using ReadTheDocs or GitBook?

ReadTheDocs and GitBook are well established solutions for documentation, but they don't provide automatic compilation and evaluation of Haskell code. This is error prone and can lead to confuse your users.

Tintin is tightly integrated with Haskell and its tools, helping you to document your library in a very easy way.

Projects using Tintin

Please submit a PR if you are using Tintin!

λ	λ
Tintin	A softer alternative to Haddock
backprop	Heterogeneous automatic differentiation