From: marcandre-ruby-core@... Date: 2020-05-21T20:31:10+00:00 Subject: [ruby-core:98477] [Ruby master Misc#16802] Prefer use of RHS assigment in documentation Issue #16802 has been updated by marcandre (Marc-Andre Lafortune). I'm also not a big fan, but even if it becomes official it's not a good idea documentation-wise as it currently distinguishes cases where the return is self; there's no way to do this with the right assignment operator. ``` hsh.merge!(other_hash1, other_hash2, ...) -> hsh ``` ---------------------------------------- Misc #16802: Prefer use of RHS assigment in documentation https://bugs.ruby-lang.org/issues/16802#change-85752 * Author: ioquatix (Samuel Williams) * Status: Closed * Priority: Normal * Assignee: ioquatix (Samuel Williams) ---------------------------------------- Many documentation uses some format like this: ``` Hash.new -> hash ``` Now that RHS assignment is a thing, we can make the documentation valid Ruby code: ``` Hash.new => hash ``` There is some discussion here: https://github.com/ruby/ruby/pull/3026 I would like to start changing the existing documentation to use this, and in addition, make an automated sweep of the entire code base to update to the new syntax. -- https://bugs.ruby-lang.org/ Unsubscribe: