Want to get involved with this doc stuff? I'm making it even easier

Ruby
1

Hey guys-

Some of you may remember my blog post about how to contribute to
Ruby’s docs:
http://blog.steveklabnik.com/2011/05/10/contributing-to-ruby-s-documentation.html

I’m one-upping the easy factor:
http://blog.steveklabnik.com/2011/08/22/im-making-it-dead-simple-to-contribute-to-ruby-s-documentation.html

tl;dr: I’ll make patches for you, if you tell me what needs to change
in the docs. Email me.

-Steve

2

Steve K. wrote in post #1017919:

tl;dr:

lol.

3

<3

4

I just upped the ante again: They don’t even need to be patches.
Re-read the post if you read it before. :wink:

5

Ok but what has to be done?

I mean actually … the whole documentation could be scrapped and
replace with an online book that has a complete API coverage & exampleas
as well … :>

I mean, I would actually move to a web-based interface entirely and have
(registered) users contribute via an online fashion.

6

On Aug 23, 2011 9:14 AM, “Marc H.” [email protected] wrote:

Ok but what has to be done?

I mean actually … the whole documentation could be scrapped and
replace with an online book that has a complete API coverage & exampleas
as well … :>

I mean, I would actually move to a web-based interface entirely and have
(registered) users contribute via an online fashion.

When can you have this finished, Steve? :wink:

7

Marc H. [email protected] wrote:

I mean, I would actually move to a web-based interface entirely and have
(registered) users contribute via an online fashion.

I applaud Steve for taking a registration-free approach here.

Registration is an extra barrier to entry and all sign-on systems suck.
Most (if not all) people already have access to email from a provider
of their choosing.

(HTML and top-posted emails still suck, though)

8

tl;dr: I’ll make patches for you, if you tell me what needs to change
in the docs. Email me.

Sweet :).

9

I mean, I would actually move to a web-based interface entirely

Sure. Write that, port all the docs, get it accepted by Ruby Core. In
the
meantime, I’ll be applying patches people send me.

Organizers call this ‘diversity of tactics.’