spark-instrumented-optimizer/python/docs/source
HyukjinKwon 5250841537
[SPARK-33256][PYTHON][DOCS] Clarify PySpark follows NumPy documentation style
### What changes were proposed in this pull request?

This PR adds few lines about docstring style to document that PySpark follows [NumPy documentation style](https://numpydoc.readthedocs.io/en/latest/format.html). We all completed the migration to NumPy documentation style at SPARK-32085.

Ideally we should have a page like https://pandas.pydata.org/docs/development/contributing_docstring.html but I would like to leave it as a future work.

### Why are the changes needed?

To tell developers that PySpark now follows NumPy documentation style.

### Does this PR introduce _any_ user-facing change?

No, it's a change in unreleased branches yet.

### How was this patch tested?

Manually tested via `make clean html` under `python/docs`:

![Screen Shot 2020-12-06 at 1 34 50 PM](https://user-images.githubusercontent.com/6477701/101271623-d5ce0380-37c7-11eb-93ac-da73caa50c37.png)

Closes #30622 from HyukjinKwon/SPARK-33256.

Authored-by: HyukjinKwon <gurwls223@apache.org>
Signed-off-by: Dongjoon Hyun <dongjoon@apache.org>
2020-12-06 01:22:24 -08:00
..
_static Spelling r common dev mlib external project streaming resource managers python 2020-11-27 10:22:45 -06:00
_templates/autosummary Spelling r common dev mlib external project streaming resource managers python 2020-11-27 10:22:45 -06:00
development [SPARK-33256][PYTHON][DOCS] Clarify PySpark follows NumPy documentation style 2020-12-06 01:22:24 -08:00
getting_started Spelling r common dev mlib external project streaming resource managers python 2020-11-27 10:22:45 -06:00
migration_guide [SPARK-32191][FOLLOW-UP][PYTHON][DOCS] Indent the table and reword the main page in migration guide 2020-09-01 15:08:03 +09:00
reference [SPARK-33556][ML] Add array_to_vector function for dataframe column 2020-12-01 09:52:19 +09:00
user_guide [SPARK-33530][CORE] Support --archives and spark.archives option natively 2020-12-01 13:43:02 +09:00
conf.py [SPARK-33243][PYTHON][BUILD] Add numpydoc into documentation dependency 2020-10-27 14:03:57 +09:00
index.rst Spelling r common dev mlib external project streaming resource managers python 2020-11-27 10:22:45 -06:00