Skip to content

Comments

[PYSPARK][DOCS] [MINOR]Changed :func: to :attr: Sphinx roles, fixed links in documentation of Data{Frame,Stream}{Reader,Writer}.#27553

Closed
DavidToneian wants to merge 1 commit intoapache:masterfrom
DavidToneian:docfix-DataFrameReader-DataFrameWriter-DataStreamReader-DataStreamWriter
Closed

[PYSPARK][DOCS] [MINOR]Changed :func: to :attr: Sphinx roles, fixed links in documentation of Data{Frame,Stream}{Reader,Writer}.#27553
DavidToneian wants to merge 1 commit intoapache:masterfrom
DavidToneian:docfix-DataFrameReader-DataFrameWriter-DataStreamReader-DataStreamWriter

Conversation

@DavidToneian
Copy link
Contributor

This commit is published into the public domain.

What changes were proposed in this pull request?

This PR fixes the documentation of DataFrameReader, DataFrameWriter, DataStreamReader, and DataStreamWriter, where attributes of other classes were misrepresented as functions. Additionally, creation of hyperlinks across modules was fixed in these instances.

Why are the changes needed?

The old state produced documentation that suggested invalid usage of PySpark objects (accessing attributes as though they were callable.)

Does this PR introduce any user-facing change?

No, except for improved documentation.

How was this patch tested?

No test added; documentation build runs through.

…on of `Data{Frame,Stream}{Reader,Writer}`.

This commit is published into the public domain.
@maropu maropu changed the title [MINOR][DOCS] Changed :func: to :attr: Sphinx roles, fixed links in documentation of Data{Frame,Stream}{Reader,Writer}. [PYSPARK][DOCS] [MINOR]Changed :func: to :attr: Sphinx roles, fixed links in documentation of Data{Frame,Stream}{Reader,Writer}. Feb 13, 2020
@maropu
Copy link
Member

maropu commented Feb 13, 2020

ok to test

@maropu
Copy link
Member

maropu commented Feb 13, 2020

cc: @HyukjinKwon

@SparkQA
Copy link

SparkQA commented Feb 13, 2020

Test build #118328 has finished for PR 27553 at commit 6d0f6ed.

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

HyukjinKwon pushed a commit that referenced this pull request Feb 14, 2020
…ed links in documentation of `Data{Frame,Stream}{Reader,Writer}`

This commit is published into the public domain.

### What changes were proposed in this pull request?
This PR fixes the documentation of `DataFrameReader`, `DataFrameWriter`, `DataStreamReader`, and `DataStreamWriter`, where attributes of other classes were misrepresented as functions. Additionally, creation of hyperlinks across modules was fixed in these instances.

### Why are the changes needed?
The old state produced documentation that suggested invalid usage of PySpark objects (accessing attributes as though they were callable.)

### Does this PR introduce any user-facing change?
No, except for improved documentation.

### How was this patch tested?
No test added; documentation build runs through.

Closes #27553 from DavidToneian/docfix-DataFrameReader-DataFrameWriter-DataStreamReader-DataStreamWriter.

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

Merged to master, branch-3.0 and branch-2.4.

Thanks, @DavidToneian for the contribution.

HyukjinKwon pushed a commit that referenced this pull request Feb 14, 2020
…ed links in documentation of `Data{Frame,Stream}{Reader,Writer}`

This commit is published into the public domain.

### What changes were proposed in this pull request?
This PR fixes the documentation of `DataFrameReader`, `DataFrameWriter`, `DataStreamReader`, and `DataStreamWriter`, where attributes of other classes were misrepresented as functions. Additionally, creation of hyperlinks across modules was fixed in these instances.

### Why are the changes needed?
The old state produced documentation that suggested invalid usage of PySpark objects (accessing attributes as though they were callable.)

### Does this PR introduce any user-facing change?
No, except for improved documentation.

### How was this patch tested?
No test added; documentation build runs through.

Closes #27553 from DavidToneian/docfix-DataFrameReader-DataFrameWriter-DataStreamReader-DataStreamWriter.

Authored-by: David Toneian <david@toneian.com>
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
(cherry picked from commit 25db8c7)
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
sjincho pushed a commit to sjincho/spark that referenced this pull request Apr 15, 2020
…ed links in documentation of `Data{Frame,Stream}{Reader,Writer}`

This commit is published into the public domain.

### What changes were proposed in this pull request?
This PR fixes the documentation of `DataFrameReader`, `DataFrameWriter`, `DataStreamReader`, and `DataStreamWriter`, where attributes of other classes were misrepresented as functions. Additionally, creation of hyperlinks across modules was fixed in these instances.

### Why are the changes needed?
The old state produced documentation that suggested invalid usage of PySpark objects (accessing attributes as though they were callable.)

### Does this PR introduce any user-facing change?
No, except for improved documentation.

### How was this patch tested?
No test added; documentation build runs through.

Closes apache#27553 from DavidToneian/docfix-DataFrameReader-DataFrameWriter-DataStreamReader-DataStreamWriter.

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.

4 participants