DOC: Update the examples to DataFrame.mod docstring
State: closed

Checklist for the pandas documentation sprint (ignore this if you are doing
an unrelated PR):

- [X] PR title is "DOC: update the <your-function-or-method> docstring"
- [X] The validation script passes: `scripts/validate_docstrings.py <your-function-or-method>`
- [X] The PEP8 style check passes: `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [X] The html version looks good: `python doc/make.py --single <your-function-or-method>`
- [X] It has been proofread on language by another sprint participant

Please include the output of the validation script below between the "```" ticks:

```
################################################################################
####################### Docstring (pandas.DataFrame.mod) #######################
################################################################################

Modulo of dataframe and other, element-wise (binary operator `mod`).

Equivalent to ``dataframe % other``, but with support to substitute a fill_value for
missing data in one of the inputs.

Parameters
----------
other : Series, DataFrame, or constant
axis : {0, 1, 'index', 'columns'}
    For Series input, axis to match Series index on
level : int or name
    Broadcast across a level, matching Index values on the
    passed MultiIndex level
fill_value : None or float value, default None
    Fill existing missing (NaN) values, and any new element needed for
    successful DataFrame alignment, with this value before computation.
    If data in both corresponding DataFrame locations is missing
    the result will be missing

Notes
-----
Mismatched indices will be unioned together

Returns
-------
result : DataFrame

Examples
--------

>>> a = pd.DataFrame([2, 4, np.nan, 6.2], index=["a","b","c","d"],
...                  columns=['one'])
>>> a
    one
a   2.0
b   4.0
c   NaN
d   6.2
>>> a.mod(3, fill_value=-1)
    one
a   2.0
b   1.0
c   2.0
d   0.2
>>> b = pd.DataFrame(dict(one=[np.nan, 2, 3, 14], two=[np.nan, 1, 1, 3]),
...                  index=['a', 'b', 'c', 'd'])
>>> b
    one   two
a   NaN   NaN
b   2.0   1.0
c   3.0   1.0
d   14.0  3.0
>>> c = pd.DataFrame(dict(one=[np.nan, np.nan, 6, np.nan],
...                       three=[np.nan, 10, np.nan, -7]),
...                  index=['a', 'b', 'd', 'e'])
>>> c
    one three
a   NaN NaN
b   NaN 10.0
d   6.0 NaN
e   NaN -7.0
>>> b.mod(c, fill_value=3)
    one   three two
a   NaN   NaN   NaN
b   2.0   3.0   1.0
c   0.0   NaN   1.0
d   2.0   NaN   0.0
e   NaN  -4.0   NaN


See also
--------
DataFrame.rmod

################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	Use only one blank line to separate sections or paragraphs
	Errors in parameters section
		Parameter "other" has no description
		Parameter "axis" description should finish with "."
		Parameter "level" description should finish with "."
		Parameter "fill_value" description should finish with "."
	Missing description for See Also "DataFrame.rmod" reference
```

If the validation script still gives errors, but you think there is a good reason
to deviate in this case (and there are certainly such cases), please state this
explicitly.

I only added  the examples. These errors were present before I added the examples.


Labels:
name: Docs

Comments:
# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=h1) Report
> :exclamation: No coverage uploaded for pull request base (`master@44691ee`). [Click here to learn what that means](https://docs.codecov.io/docs/error-reference#section-missing-base-commit).
> The diff coverage is `100%`.

[![Impacted file tree graph](https://codecov.io/gh/pandas-dev/pandas/pull/20406/graphs/tree.svg?width=650&height=150&src=pr&token=eZ4WkYLtcO)](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=tree)

```diff
@@            Coverage Diff            @@
##             master   #20406   +/-   ##
=========================================
  Coverage          ?   91.92%           
=========================================
  Files             ?      160           
  Lines             ?    49915           
  Branches          ?        0           
=========================================
  Hits              ?    45884           
  Misses            ?     4031           
  Partials          ?        0
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `90.3% <100%> (?)` | |
| #single | `42.1% <100%> (?)` | |

| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/core/ops.py](https://codecov.io/gh/pandas-dev/pandas/pull/20406/diff?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvb3BzLnB5) | `96.47% <100%> (ø)` | |

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=continue).
> **Legend** - [Click here to learn more](https://docs.codecov.io/docs/codecov-delta)
> `Δ = absolute <relative> (impact)`, `ø = not affected`, `? = missing data`
> Powered by [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=footer). Last update [44691ee...5b21867](https://codecov.io/gh/pandas-dev/pandas/pull/20406?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).

Thanks @ailchau !