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