about summary refs log tree commit homepage
path: root/HACKING
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2015-01-10 03:58:35 +0000
committerEric Wong <e@80x24.org>2015-04-22 18:55:42 +0000
commit1dd67c4cf3e65f065f07f397f69517c9424d129a (patch)
tree80552f9d980d9cfe7b7fe6f71f9f54a5ea5a6c98 /HACKING
parentd6244f78af7910317733fb32adef20f3f3986871 (diff)
downloadunicorn-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--HACKING8
1 files changed, 3 insertions, 5 deletions
diff --git a/HACKING b/HACKING
index acb9f9d..9b4da1b 100644
--- a/HACKING
+++ b/HACKING
@@ -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: