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

Issue #16802 has been updated by duerst (Martin D=FCrst).


I'm not sure it's a good idea. There's some value in distinguishing between=
 an actual right-hand-side assignment and the resulting value of an express=
ion (where expression includes right-hand-side assignments :-).

Also, as far as I understand, right-hand-side assignment is still experimen=
tal (but maybe I got that wrong).

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

* 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 Rub=
y code:

```
  Hash.new            =3D> 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 t=
he new syntax.



-- =

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

Unsubscribe: <mailto:[e-mail]?subject=3Dunsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>