From: "zzak (Zachary Scott)" <e@...>
Date: 2013-10-16T00:19:08+09:00
Subject: [ruby-core:57880] [ruby-trunk - Bug #8889][Rejected] Nodoc large	parts of RSS


Issue #8889 has been updated by zzak (Zachary Scott).

Status changed from Feedback to Rejected

See ruby-core:57399

Thank you for the patch! Please send more :)
----------------------------------------
Bug #8889: Nodoc large parts of RSS
https://bugs.ruby-lang.org/issues/8889#change-42476

Author: steveklabnik (Steve Klabnik)
Status: Rejected
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: doc
Target version: 
ruby -v: 2.1.0-dev
Backport: 1.9.3: UNKNOWN, 2.0.0: UNKNOWN


Continuing my focus on getting RSS documented, I believe that large amounts of it should be nodoc'd. The vast majority of the code is actually internal implementation detail; the big stuff is the builder DSL, which isn't really served by API-level documentation.

The attached patch nodocs everything that's in the top-level files, those being the ones for the specific formats. If it's agreed that most of the rest should be nodoc'd as well, I can do that in another patch, or if we do want api-level docs for all of this, I can work on actually writing those.


-- 
http://bugs.ruby-lang.org/