Skip to content


Subversion checkout URL

You can clone with
Download ZIP


Add docs badge to README #1000

wants to merge 1 commit into from

2 participants


Hi there,

this patch adds a docs badge to the README to show off inline-documentation to the casual visitor: Inline docs

It links to Inch Pages, a project that tries to raise the visibility of documentation in Ruby projects. The status page for Formtastic is

Inch Pages is still in it's infancy, but already used by projects like Reek and libnotify.

What do you think?


Looks like this needs to be rebased or merged against master, but I'm not thrilled with the method of evaluating documentation. It seems to be method based rather than class based. I've poured a heap of effort into documenting high level classes, modules and the small number of public helpers that a user of this library would actively use.

Maybe there's a code smell in there, but it doesn't strike me as a great evaluation of our documentation.

Anyhoo, would likely merge if it applies cleanly, but I'm not going to go out of my way right now. Please re-open if you're still keen to pursue!

@rrrene rrrene referenced this pull request

Add docs badge to README #1013

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on Feb 25, 2014
  1. @rrrene

    Add docs badge to README

    rrrene authored
This page is out of date. Refresh to see the latest.
Showing with 1 addition and 1 deletion.
  1. +1 −1  README.textile
2  README.textile
@@ -1,6 +1,6 @@
h1. Formtastic
+!!: !!:
Formtastic is a Rails FormBuilder DSL (with some other goodies) to make it far easier to create beautiful, semantically rich, syntactically awesome, readily stylable and wonderfully accessible HTML forms in your Rails applications.
Something went wrong with that request. Please try again.