DOC: updated the examples in date_range function of Pandas
I have updated some little typos of full stop that I came across while validating and added some examples for `date_range` function in pandas/core/indexes/datetimes.py . Please review this and let me know if I can make it better.

thanks
Thanks. Can you also run the docstring validator on this and paste the output? #20119 is also working on date_range.... let's coordinate this. @datapythonista  @Chitrank-Dixit you've got two PRs with the same code as @jreback says. Can you address the comments in both just in one, and close the other please? Hello @Chitrank-Dixit! Thanks for updating the PR.



Cheers ! There are no PEP8 issues in this Pull Request. :beers: 

##### Comment last updated on March 16, 2018 at 21:06 Hours UTC # [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/20128?src=pr&el=h1) Report
> :exclamation: No coverage uploaded for pull request base (`master@afa6c42`). [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/20128/graphs/tree.svg?token=eZ4WkYLtcO&src=pr&width=650&height=150)](https://codecov.io/gh/pandas-dev/pandas/pull/20128?src=pr&el=tree)

```diff
@@            Coverage Diff            @@
##             master   #20128   +/-   ##
=========================================
  Coverage          ?   91.78%           
=========================================
  Files             ?      152           
  Lines             ?    49192           
  Branches          ?        0           
=========================================
  Hits              ?    45152           
  Misses            ?     4040           
  Partials          ?        0
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `90.17% <100%> (?)` | |
| #single | `41.82% <38.88%> (?)` | |

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

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/20128?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/20128?src=pr&el=footer). Last update [afa6c42...1f0eb98](https://codecov.io/gh/pandas-dev/pandas/pull/20128?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).
 I have closed the other PR, I am working on this one, got stuck in one of the work related problems.

@TomAugspurger I have run the docstring validator and got the following output for the `pandas/core/indexes/datetimes.py` file

`################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	No summary found (a short summary in a single line should be present at the beginning of the docstring)
	Errors in parameters section
		Parameters {'kwargs'} not documented
	See Also section not found` @Chitrank-Dixit try to follow this document step by step:
https://python-sprints.github.io/pandas/guide/pandas_docstring.html

Should help you understand the errors. If there is any that you don't understand after reading it, please let me know which. Hey @datapythonista,

I am little confused with the kwargs argument. I am unsure about this because I have to see the code and how kwargs argument works in date_range function. Can we go ahead with merging only the example section till them I would come up with good summary and see also section. Personally, I don't see the value in merging it by parts. You don't need to rush, if you don't have time now, continue when you do. The changes won't be in pandas until the next release anyway. ;)  ![fireshot capture 004 - pandas date_range pandas 0 23 0 dev_ - file____users_taugspurger_sandbox_](https://user-images.githubusercontent.com/1312546/37493084-b30e0d1c-2871-11e8-84dd-88e3c5620e7f.png)
 Thanks @Chitrank-Dixit !