[DOC] Change to handling of aliases (#7340)
Change to handling of aliases
This commit is contained in:
parent
759d23584e
commit
ea50765926
Notes:
git
2023-02-19 19:42:00 +00:00
Merged-By: BurdetteLamar <BurdetteLamar@Yahoo.com>
@ -241,7 +241,6 @@ The general structure of the method documentation should be:
|
||||
- Details and examples.
|
||||
- Argument description (if necessary).
|
||||
- Corner cases and exceptions.
|
||||
- Aliases.
|
||||
- Related methods (optional).
|
||||
|
||||
### Calling Sequence (for methods written in C)
|
||||
@ -328,7 +327,7 @@ Return types:
|
||||
|
||||
Aliases:
|
||||
|
||||
- Omit aliases from the `call-seq`, but mention them near the end (see below).
|
||||
- Omit aliases from the `call-seq`.
|
||||
|
||||
### Synopsis
|
||||
|
||||
@ -398,14 +397,6 @@ you do not need to document that a `TypeError` is raised if a non-integer
|
||||
is passed. Do not provide examples of exceptions being raised unless
|
||||
that is a common case, such as `Hash#fetch` raising a `KeyError`.
|
||||
|
||||
### Aliases
|
||||
|
||||
Mention aliases in the form
|
||||
|
||||
```
|
||||
// Array#find_index is an alias for Array#index.
|
||||
```
|
||||
|
||||
### Related Methods (optional)
|
||||
|
||||
In some cases, it is useful to document which methods are related to
|
||||
|
Loading…
x
Reference in New Issue
Block a user