diff options
author | Eric Wong <e@80x24.org> | 2015-01-10 03:58:35 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2015-04-22 18:55:42 +0000 |
commit | 1dd67c4cf3e65f065f07f397f69517c9424d129a (patch) | |
tree | 80552f9d980d9cfe7b7fe6f71f9f54a5ea5a6c98 /HACKING | |
parent | d6244f78af7910317733fb32adef20f3f3986871 (diff) | |
download | unicorn-1dd67c4cf3e65f065f07f397f69517c9424d129a.tar.gz |
wrongdoc was difficult to maintain because of the tidy-ffi dependency and the HTML5 changes in Darkfish could not be handled well by Tidy. olddoc is superior as it generates leaner HTML which loads faster, requires less scrolling and less processing power to render. Aesthetic comparisons are subjective of course but completely unimportant compared to speed and accessibility. The presence of images and CSS on the old (Darkfish-based) site probably set unreasonable expectations as to my ability and willingness to view such things. No more, the new website is entirely simple HTML which renders well with even the wimpiest browser.
Diffstat (limited to 'HACKING')
-rw-r--r-- | HACKING | 8 |
1 files changed, 3 insertions, 5 deletions
@@ -57,10 +57,8 @@ programming experience will come in handy (or be learned) here. === Documentation -We use RDoc 2.5.x with Darkfish for documentation as much as possible, -if you're on Ruby 1.8 you want to install the latest "rdoc" gem. Due to -the lack of RDoc-to-manpage converters we know about, we're writing -manpages in Markdown and converting to troff/HTML with Pandoc. +Due to the lack of RDoc-to-manpage converters we know about, we're +writing manpages in Markdown and converting to troff/HTML with Pandoc. Please wrap documentation at 72 characters-per-line or less (long URLs are exempt) so it is comfortably readable from terminals. @@ -114,7 +112,7 @@ don't email the git mailing list or maintainer with Unicorn patches :) In order to build the gem, you must install the following components: - * wrongdoc + * olddoc (RubyGem) * pandoc You can build the Unicorn gem with the following command: |