Where should I put an RMagick installation FAQ?

ruby-talk
1

About 95% of the email I get about RMagick is about installation problems so I'm thinking about writing an "RMagick installation FAQ." This doc would cover planning questions like "which package should I use?", O/S specific issues, how to resolve problems, etc.

Where is the best place to put such a document? To be useful, it should be read _before_ starting to install RMagick, even before downloading it, so putting the information in the tarball or gem itself is no good. (Besides, a lot of this information is already in the README files.) What about a link from the RMagick home page (rmagick.rubyforge.org)? Or as a thread in the RMagick "Hints & Tips" forum on RubyForge? Or somewhere else entirely?

Where would _you_ look if you were thinking about installing RMagick?

2

[...]

Where would _you_ look if you were thinking about installing
RMagick?

The homepage link on the RubyForge project page.

Regards,
  Stefan

···

On Saturday 05 November 2005 18:47, Timothy Hunter wrote:

3

Timothy Hunter wrote:

About 95% of the email I get about RMagick is about installation
problems so I'm thinking about writing an "RMagick installation FAQ."

Looks good, Tim!

http://rmagick.rubyforge.org/install-faq.html

4

Stefan Lang wrote:

[...]
> Where would _you_ look if you were thinking about installing
> RMagick?

The homepage link on the RubyForge project page.

Yes: http://rmagick.rubyforge.org/
  (under the 'Prerequisites' heading you already have)

BTW:
  Download ImageMagick
    ImageMagick Download Sites ->
      http://www.imagemagick.org/www/archives.html

The requested URL /www/archives.html was not found on this server.

daz

···

On Saturday 05 November 2005 18:47, Timothy Hunter wrote:

5

daz wrote:

Timothy Hunter wrote:

About 95% of the email I get about RMagick is about installation
problems so I'm thinking about writing an "RMagick installation FAQ."

Looks good, Tim!

http://rmagick.rubyforge.org/install-faq.html

Thanks! I notice it only took two days for a blog to link to it: http://betweengo.com/ruby-on-rails/2005/11/08/setting-up-a-windows-ruby-on-rails-environment/