Skip to content

Comments

[SPARK-30859][PYSPARK][DOCS][MINOR] Fixed docstring syntax issues preventing proper compilation of documentation.#27613

Closed
DavidToneian wants to merge 2 commits intoapache:masterfrom
DavidToneian:SPARK-30859
Closed

[SPARK-30859][PYSPARK][DOCS][MINOR] Fixed docstring syntax issues preventing proper compilation of documentation.#27613
DavidToneian wants to merge 2 commits intoapache:masterfrom
DavidToneian:SPARK-30859

Conversation

@DavidToneian
Copy link
Contributor

This commit is published into the public domain.

What changes were proposed in this pull request?

Some syntax issues in docstrings have been fixed.

Why are the changes needed?

In some places, the documentation did not render as intended, e.g. parameter documentations were not formatted as such.

Does this PR introduce any user-facing change?

Slight improvements in documentation.

How was this patch tested?

Manual testing. No new Sphinx warnings arise due to this change.

@DavidToneian DavidToneian changed the title SPARK-30859: Fixed docstring syntax issues preventing proper compilation of documentation. [SPARK-30859][PYSPARK][DOCS][MINOR] Fixed docstring syntax issues preventing proper compilation of documentation. Feb 17, 2020
@HyukjinKwon
Copy link
Member

ok to test

@HyukjinKwon
Copy link
Member

@DavidToneian, can you check if there are more instances to fix in PySpark API documentation?

@SparkQA
Copy link

SparkQA commented Feb 18, 2020

Test build #118602 has finished for PR 27613 at commit 5699080.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@DavidToneian
Copy link
Contributor Author

@HyukjinKwon: These are the only instances I found when I searched for a space followed by a colon (" :") in the output HTML docs.

HyukjinKwon pushed a commit that referenced this pull request Feb 18, 2020
…venting proper compilation of documentation

This commit is published into the public domain.

### What changes were proposed in this pull request?
Some syntax issues in docstrings have been fixed.

### Why are the changes needed?
In some places, the documentation did not render as intended, e.g. parameter documentations were not formatted as such.

### Does this PR introduce any user-facing change?
Slight improvements in documentation.

### How was this patch tested?
Manual testing. No new Sphinx warnings arise due to this change.

Closes #27613 from DavidToneian/SPARK-30859.

Authored-by: David Toneian <david@toneian.com>
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
(cherry picked from commit 504b513)
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
@HyukjinKwon
Copy link
Member

Merged to master and branch-3.0.

sjincho pushed a commit to sjincho/spark that referenced this pull request Apr 15, 2020
…venting proper compilation of documentation

This commit is published into the public domain.

### What changes were proposed in this pull request?
Some syntax issues in docstrings have been fixed.

### Why are the changes needed?
In some places, the documentation did not render as intended, e.g. parameter documentations were not formatted as such.

### Does this PR introduce any user-facing change?
Slight improvements in documentation.

### How was this patch tested?
Manual testing. No new Sphinx warnings arise due to this change.

Closes apache#27613 from DavidToneian/SPARK-30859.

Authored-by: David Toneian <david@toneian.com>
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants