DOC: updated docstring for nanoseconds function per doc guidelines
State: closed

- [ ] closes #xxxx
- [ ] tests added / passed
- [X] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

```
################################################################################
################### Docstring (pandas.Timedelta.nanoseconds) ###################
################################################################################

Return the number of nanoseconds (n), where 0 <= n < 1 microsecond.

Returns
-------
int : Number of nanoseconds

See Also
--------
Timedelta.components : Return all attributes with assigned values (i.e.
    days, seconds, microseconds, nanoseconds)

################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	No extended summary found
	No examples section found
```

Labels:
name: Docs
name: Datetime
description: Datetime data dtype

Comments:
# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/21065?src=pr&el=h1) Report
> Merging [#21065](https://codecov.io/gh/pandas-dev/pandas/pull/21065?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/501f0418c00064f5041ef156ed5a2289a9064da3?src=pr&el=desc) will **not change** coverage.
> The diff coverage is `n/a`.

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

```diff
@@           Coverage Diff           @@
##           master   #21065   +/-   ##
=======================================
  Coverage   91.83%   91.83%           
=======================================
  Files         153      153           
  Lines       49495    49495           
=======================================
  Hits        45454    45454           
  Misses       4041     4041
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `90.23% <ø> (ø)` | :arrow_up: |
| #single | `41.88% <ø> (ø)` | :arrow_up: |


------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/21065?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/21065?src=pr&el=footer). Last update [501f041...4237391](https://codecov.io/gh/pandas-dev/pandas/pull/21065?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).

Made the changes suggested...

```
################################################################################
################### Docstring (pandas.Timedelta.nanoseconds) ###################
################################################################################

Return the number of nanoseconds (n), where 0 <= n < 1 microsecond.

Returns
-------
int
    Number of nanoseconds.

See Also
--------
Timedelta.components : Return all attributes with assigned values (i.e.
    days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds).

Examples
--------
**Using string input**

>>> td = pd.Timedelta('1 days 2 min 3 us 42 ns')
>>> td.nanoseconds
42

**Using integer input**

>>> td = pd.Timedelta(42, unit='ns')
>>> td.nanoseconds
42

################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	No extended summary found
```
So... what is the resolution path if the travis-ci build fails?
not real familiar with Travis and thus not real sure where I should go from here.

```
The command "ci/lint.sh" exited with 1.
0.00s$ echo "checking imports"
checking imports
```
Typically things won't get merged if they have errors. You can look at the logs to see what happens - in this case your change is failing the LINT check:

```bash
pandas/_libs/tslibs/timedeltas.pyx:804:80: E501 line too long (84 > 79 characters)
pandas/_libs/tslibs/timedeltas.pyx:818:11: W291 trailing whitespace
```

You should get the same error locally if you run flake8 (see contributing guide for details)
* Removed the trailing whitespace.
* Modified linebreaks to ensure that the text was within line length limits.
* Ran the `git diff upstream/master -u -- "*.py" | flake8 --diff` command as required in the documentation guide.


```
################################################################################
################### Docstring (pandas.Timedelta.nanoseconds) ###################
################################################################################

Return the number of nanoseconds (n), where 0 <= n < 1 microsecond.

Returns
-------
int
    Number of nanoseconds.

See Also
--------
Timedelta.components : Return all attributes with assigned values (i.e.
    days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds).

Examples
--------
**Using string input**

>>> td = pd.Timedelta('1 days 2 min 3 us 42 ns')
>>> td.nanoseconds
42

**Using integer input**

>>> td = pd.Timedelta(42, unit='ns')
>>> td.nanoseconds
42

################################################################################
################################## Validation ##################################
################################################################################

Errors found:
	No extended summary found
```
thanks @chalmerlowe 
Thanks for closing. My **First PR** on pandas.

There was some back and forth comments on the formatting...

I followed the examples in the [docstrings guide: ](https://python-sprints.github.io/pandas/guide/pandas_docstring.html)

**With a single return value**
```
Returns
-------
float
    Random number generated.
```

**With multiple return values**
```
Returns
-------
length : int
    Length of the returned string.
letters : str
    String of random letters.
```