[ruby-core:98009] [Ruby master Misc#16802] Prefer use of RHS assigment in documentation

Issue #16802 has been updated by jeremyevans0 (Jeremy Evans).


ioquatix (Samuel Williams) wrote in #note-6:
> Oh okay, I thought it was a sure thing at this point - where is the experimental nature of it being tracked?

It's mentioned in NEWS.md.  Both rightward assignment and endless method definition are currently considered experimental, and I think we shouldn't have any internal code or documentation use them until that is no longer the case.

----------------------------------------
Misc #16802: Prefer use of RHS assigment in documentation
https://bugs.ruby-lang.org/issues/16802#change-85240

* Author: ioquatix (Samuel Williams)
* Status: Open
* 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: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>