From: shevegen@... Date: 2017-12-08T11:19:56+00:00 Subject: [ruby-core:84129] [Ruby trunk Bug#14160] JSON#generate documentation wrong/misleading Issue #14160 has been updated by shevegen (Robert A. Heiler). You are right, the statement in the documentation that .generate() only allows "objects or arrays" is technically not logical. Firstly, in ruby everything is an object, or at the least, when we include Integers and Symbols, object-like in their behaviour (they have the same object_id all the time of course, unlike e. g. String objects). I would suggest to change the wording, to also expand it with more examples, not just via "1" alone, and to clear up the comment about JSON.generate(). ---------------------------------------- Bug #14160: JSON#generate documentation wrong/misleading https://bugs.ruby-lang.org/issues/14160#change-68230 * Author: StefanPochmann (Stefan Pochmann) * Status: Open * Priority: Normal * Assignee: * Target version: * ruby -v: * Backport: 2.3: UNKNOWN, 2.4: UNKNOWN ---------------------------------------- https://docs.ruby-lang.org/en/trunk/JSON.html#module-JSON-label-Generating+JSON That says `JSON.generate` only allows "objects or arrays", that `to_json` allows more, and uses `1.to_json` as an example for that. But I just tried `JSON.generate(1)` and it works as well. What's up with that? https://docs.ruby-lang.org/en/trunk/JSON.html#method-i-generate That talks about `state` a lot. I think it should say `opts`, as that is the argument name, no? Also, it says "state is * a JSON::State object". Note the "*". I think this should be a bullet point, i.e., "a JSON::State object" should be an item in the list following it. -- https://bugs.ruby-lang.org/ Unsubscribe: