Re: Ruby Docs with annotations and searching

"Conor Hunt" <[email protected]>
Newsgroups gmane.comp.lang.ruby.documentation
Message-ID <[email protected]>
> I disagree with some things.
> * I post more than once a minute, regularly.  Sometimes I go back and
> make one little change five seconds later.
> * Captcha has plenty of workarounds and is annoying for regular
> people.  I hate it.
> * Creating *yet another* user is annoying.. but most people will be ok
> with it if they're serious.  Is it possible to leverage something like
> rubyforge logins?
> * A lot of this feels just like a wiki.  Why not just leverage a wiki?
> (with a sane markup language and NoFiNgCamelCase)

A lot of the spam prevention things seem like good ideas. I look at
what ruby/rails libs are out there to help with it.

I modeled this site after the way that the very successful online PHP
documentation works (and mysql). Their system works like my site.
Users add comments below sections. Then when the docs are being
updated the maintainers go through and roll useful user comments into
the main documentation. This has the benefit of keeping the main
documentation well formatted and stable. I'd also prefer to keep it
simple to add comments, no login and no editing.

--
Conor
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.