DOC: update the pandas.Series.dt.is_month_start docstring

[janelle]

Checklist for the pandas documentation sprint (ignore this if you are doing
an unrelated PR):

• [ X] PR title is "DOC: update the 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>
• It has been proofread on language by another sprint participant

Please include the output of the validation script below between the "```" ticks:

################################################################################
################# Docstring (pandas.Series.dt.is_month_start)  #################
################################################################################

Return a boolean indicating if the date is the first day of the month.

Returns
-------
is_month_start : Series of boolean

See Also
--------
is_month_end : Returns a boolean indicating if the date is the last day of the month.

Examples
--------
>>> import pandas as pd
>>> dates = pd.Series(pd.date_range("2018-02-27", periods = 3))
>>> dates
0   2018-02-27
1   2018-02-28
2   2018-03-01
dtype: datetime64[ns]
>>> dates.dt.is_month_start
0    False
1    False
2    True
dtype: bool

################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	No extended summary found

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.

This function does not require an extended summary. Peers find it very clear with a short summary too.

[pep8speaks]

Hello @janelle! Thanks for updating the PR.

• In the file pandas/core/indexes/datetimes.py, following are the PEP8 issues :

Line 1731:80: E501 line too long (83 > 79 characters)

Comment last updated on March 10, 2018 at 15:01 Hours UTC

[arnau126]

PEP8 doesn't allow spaces around keyword parameters. i.e.: periods=3, instead of periods = 3

[arnau126]

import pandas as pd is not necessary.

[arnau126]

Next line should be indented:

        is_month_end : Returns a boolean indicating if the date is the last day
            of the month.

[janelle]

thanks for reviewing, adjusted line lengths and writing style now.

[janelle]

@arnau126 adjusted line lengths and writing style

[CalmDownKarm]

This PR is perhaps no longer relevant, the _field_accessor(...) transform was replaced by the _wrap_field_accessor(name) in this commit @datapythonista

[datapythonista]

@CalmDownKarm the function has been moved here:

• https://github.com/pandas-dev/pandas/blob/master/pandas/core/arrays/datetimes.py#L945

I think the best would be to start a fresh branch from master, and copy the code from the docstring in this PR to that location.

CC: @jbrockmendel

[datapythonista]

Discontinued and superseded by #23051