Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

[SPARK-39677][SQL][DOCS] Fix args formatting of the regexp and like functions #37082

Closed
wants to merge 3 commits into from

Conversation

MaxGekk
Copy link
Member

@MaxGekk MaxGekk commented Jul 5, 2022

What changes were proposed in this pull request?

In the PR, I propose to fix args formatting of some regexp functions by adding explicit new lines. That fixes the following items in arg lists.

Before:

Screenshot 2022-07-05 at 09 48 28

After:

Screenshot 2022-07-05 at 11 06 13

Why are the changes needed?

To improve readability of Spark SQL docs.

Does this PR introduce any user-facing change?

No.

How was this patch tested?

By building docs and checking manually:

$ SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 SKIP_RDOC=1 bundle exec jekyll build

@MaxGekk MaxGekk changed the title [SPARK-39677][SQL][DOCS] Fix args formatting of the regexp and like functions [WIP][SPARK-39677][SQL][DOCS] Fix args formatting of the regexp and like functions Jul 5, 2022
@github-actions github-actions bot added the SQL label Jul 5, 2022
@MaxGekk MaxGekk changed the title [WIP][SPARK-39677][SQL][DOCS] Fix args formatting of the regexp and like functions [SPARK-39677][SQL][DOCS] Fix args formatting of the regexp and like functions Jul 5, 2022
@MaxGekk
Copy link
Member Author

MaxGekk commented Jul 5, 2022

Merging to master/3.3/3.2/3.1. Thank you, @HyukjinKwon for review.

MaxGekk added a commit that referenced this pull request Jul 5, 2022
…unctions

### What changes were proposed in this pull request?
In the PR, I propose to fix args formatting of some regexp functions by adding explicit new lines. That fixes the following items in arg lists.

Before:

<img width="745" alt="Screenshot 2022-07-05 at 09 48 28" src="https://user-images.githubusercontent.com/1580697/177274234-04209d43-a542-4c71-b5ca-6f3239208015.png">

After:

<img width="704" alt="Screenshot 2022-07-05 at 11 06 13" src="https://user-images.githubusercontent.com/1580697/177280718-cb05184c-8559-4461-b94d-dfaaafda7dd2.png">

### Why are the changes needed?
To improve readability of Spark SQL docs.

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

### How was this patch tested?
By building docs and checking manually:
```
$ SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 SKIP_RDOC=1 bundle exec jekyll build
```

Closes #37082 from MaxGekk/fix-regexp-docs.

Authored-by: Max Gekk <max.gekk@gmail.com>
Signed-off-by: Max Gekk <max.gekk@gmail.com>
(cherry picked from commit 4e42f8b)
Signed-off-by: Max Gekk <max.gekk@gmail.com>
@MaxGekk MaxGekk closed this in 4e42f8b Jul 5, 2022
@MaxGekk
Copy link
Member Author

MaxGekk commented Jul 5, 2022

The changes cause conflicts in 3.2 and 3.1 (probably). I will backport this PR separately.

MaxGekk added a commit to MaxGekk/spark that referenced this pull request Jul 5, 2022
…unctions

In the PR, I propose to fix args formatting of some regexp functions by adding explicit new lines. That fixes the following items in arg lists.

Before:

<img width="745" alt="Screenshot 2022-07-05 at 09 48 28" src="https://user-images.githubusercontent.com/1580697/177274234-04209d43-a542-4c71-b5ca-6f3239208015.png">

After:

<img width="704" alt="Screenshot 2022-07-05 at 11 06 13" src="https://user-images.githubusercontent.com/1580697/177280718-cb05184c-8559-4461-b94d-dfaaafda7dd2.png">

To improve readability of Spark SQL docs.

No.

By building docs and checking manually:
```
$ SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 SKIP_RDOC=1 bundle exec jekyll build
```

Closes apache#37082 from MaxGekk/fix-regexp-docs.

Authored-by: Max Gekk <max.gekk@gmail.com>
Signed-off-by: Max Gekk <max.gekk@gmail.com>
(cherry picked from commit 4e42f8b)
Signed-off-by: Max Gekk <max.gekk@gmail.com>
MaxGekk added a commit to MaxGekk/spark that referenced this pull request Jul 5, 2022
…unctions

In the PR, I propose to fix args formatting of some regexp functions by adding explicit new lines. That fixes the following items in arg lists.

Before:

<img width="745" alt="Screenshot 2022-07-05 at 09 48 28" src="https://user-images.githubusercontent.com/1580697/177274234-04209d43-a542-4c71-b5ca-6f3239208015.png">

After:

<img width="704" alt="Screenshot 2022-07-05 at 11 06 13" src="https://user-images.githubusercontent.com/1580697/177280718-cb05184c-8559-4461-b94d-dfaaafda7dd2.png">

To improve readability of Spark SQL docs.

No.

By building docs and checking manually:
```
$ SKIP_SCALADOC=1 SKIP_PYTHONDOC=1 SKIP_RDOC=1 bundle exec jekyll build
```

Closes apache#37082 from MaxGekk/fix-regexp-docs.

Authored-by: Max Gekk <max.gekk@gmail.com>
Signed-off-by: Max Gekk <max.gekk@gmail.com>
(cherry picked from commit 4e42f8b)
Signed-off-by: Max Gekk <max.gekk@gmail.com>
@cloud-fan
Copy link
Contributor

late LGTM

Copy link
Member

@dongjoon-hyun dongjoon-hyun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, late LGTM.

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants