From: zverok.offline@...
Date: 2018-03-02T12:44:32+00:00
Subject: [ruby-core:85890] [Ruby trunk Misc#14567] Clarify YAML docs

Issue #14567 has been reported by zverok (Victor Shepelev).

----------------------------------------
Misc #14567: Clarify YAML docs
https://bugs.ruby-lang.org/issues/14567

* Author: zverok (Victor Shepelev)
* Status: Open
* Priority: Normal
* Assignee: 
----------------------------------------
The problem I am trying to solve: If you try to understand what methods do `YAML` have, and what parameters, say, `YAML.load_file` accept, the "official" docs look [pretty unhelpful](https://docs.ruby-lang.org/en/2.5.0/YAML.html), saying, basically "This is not the docs you are looking for". 

The Psych library is mentioned and even hyperlinked, yet it mentioned as an "underlying implementation", like "something low-level that helps stdlib's YAML to do the job, don't think about Psych".

So, I felt it as a necessity to add a clarification that Psych, in fact, IS YAML, and all options and methods are documented there.

---Files--------------------------------
yaml-docs.patch (607 Bytes)


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

Unsubscribe: <mailto:ruby-core-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>