Bug #8889

Nodoc large parts of RSS

Added by Steve Klabnik 7 months ago. Updated 6 months ago.

[ruby-core:57116]
Status:Rejected
Priority:Normal
Assignee:Zachary Scott
Category:doc
Target version:-
ruby -v:2.1.0-dev Backport:1.9.3: UNKNOWN, 2.0.0: UNKNOWN

Description

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.

0001-Nodoc-large-parts-of-rss.patch Magnifier (5.57 KB) Steve Klabnik, 09/11/2013 05:18 AM

History

#1 Updated by Zachary Scott 7 months ago

  • Status changed from Open to Feedback

I like RSS, I think we should provide api-level documentation for things like Feed and Channel and Entry. The entity types might not be as important though.

Would you agree? With no objection, I would like to reject this ticket and ask for a new patch.

Thank you!

#2 Updated by Steve Klabnik 6 months ago

Sounds good to me. I'm not sure when I will get to it, but that makes sense.

#3 Updated by Zachary Scott 6 months ago

  • Status changed from Feedback to Rejected

See ruby-core:57399

Thank you for the patch! Please send more :)

Also available in: Atom PDF