ruby-changes:62688
From: Kazuhiro <ko1@a...>
Date: Sun, 23 Aug 2020 22:46:33 +0900 (JST)
Subject: [ruby-changes:62688] 30ccc7d04b (master): Fix typos
https://git.ruby-lang.org/ruby.git/commit/?id=30ccc7d04b From 30ccc7d04bb7352b05c21078fa9471196dab52ad Mon Sep 17 00:00:00 2001 From: Kazuhiro NISHIYAMA <zn@m...> Date: Sun, 23 Aug 2020 22:46:04 +0900 Subject: Fix typos diff --git a/doc/method_documentation.rdoc b/doc/method_documentation.rdoc index d13a334..26abd88 100644 --- a/doc/method_documentation.rdoc +++ b/doc/method_documentation.rdoc @@ -5,7 +5,7 @@ classes and classes in the standard library. https://github.com/ruby/ruby/blob/trunk/doc/method_documentation.rdoc#L5 == Goal -The goal when documentating a method is to impart the most important +The goal when documenting a method is to impart the most important information about the method in the least amount of time. A reader of the method documentation should be able to quickly understand the purpose of the method and how to use it. Providing too little @@ -49,7 +49,7 @@ method returns the receiver, use "self". https://github.com/ruby/ruby/blob/trunk/doc/method_documentation.rdoc#L49 In cases where the method accepts optional arguments, use a <tt>call-seq</tt> with an optional argument if the method has the same behavior when an argument -is ommitted as when the argument is passed with the default value. For example, +is omitted as when the argument is passed with the default value. For example, use: * obj.respond_to?(symbol, include_all=false) -> true or false @@ -60,7 +60,7 @@ Instead of: https://github.com/ruby/ruby/blob/trunk/doc/method_documentation.rdoc#L60 * obj.respond_to?(symbol, include_all) -> true or false However, as shown above for <tt>Array#count</tt>, use separate lines if the -behavior is different if the argument is ommitted. +behavior is different if the argument is omitted. == Synopsis @@ -107,7 +107,7 @@ provide details about the types of arguments supported. When discussing https://github.com/ruby/ruby/blob/trunk/doc/method_documentation.rdoc#L107 the types of arguments, use simple language even if less-precise, such as "level must be an integer", not "level must be an Integer-convertible object". The vast majority of use will be with the expected type, not an -argument that is explicitly convertable to the expected type, and +argument that is explicitly convertible to the expected type, and documenting the difference is not important. For methods that take blocks, it can be useful to document the type of -- cgit v0.10.2 -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/