Skip to content

Conversation

@gatorsmile
Copy link
Member

@gatorsmile gatorsmile commented Apr 30, 2020

What changes were proposed in this pull request?

This PR is to clean up the markdown file in SHOW COLUMNS page.

  • remove the unneeded embedded inline HTML markup by using the basic markdown syntax.
  • use the ``` sql for highlighting the SQL syntax.

Why are the changes needed?

Make the doc cleaner and easily editable by MD editors.

Does this PR introduce any user-facing change?

NO

How was this patch tested?

Before

Screen Shot 2020-04-29 at 5 20 11 PM

After

Screen Shot 2020-04-29 at 6 03 50 PM

<b>Note:</b>
Keywords <code>IN</code> and <code>FROM</code> are interchangeable.
</dd>
</dl>
Copy link
Member Author

Choose a reason for hiding this comment

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

Let us avoid using HTML if possible.


### Examples

{% highlight sql %}
Copy link
Member Author

Choose a reason for hiding this comment

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

We can directly use ```sql


### Related Statements

* [DESCRIBE TABLE](sql-ref-syntax-aux-describe-table.html)
Copy link
Member Author

Choose a reason for hiding this comment

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

unneeded space.

@gatorsmile
Copy link
Member Author

cc @huaxingao Could you help fix all the other pages like this example?

* **database**

Specifies an optional database name. The table is resolved from this database when it
is specified. Please note that when this parameter is specified then table
Copy link
Member Author

Choose a reason for hiding this comment

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

Nit: removed Please note that

@gatorsmile
Copy link
Member Author

Also cc @dilipbiswal

@SparkQA
Copy link

SparkQA commented Apr 30, 2020

Test build #122097 has finished for PR 28414 at commit d21377b.

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

@SparkQA
Copy link

SparkQA commented Apr 30, 2020

Test build #122099 has finished for PR 28414 at commit 88fe8b3.

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

@dilipbiswal
Copy link
Contributor

LGTM

gatorsmile added a commit that referenced this pull request Apr 30, 2020
### What changes were proposed in this pull request?
This PR is to clean up the markdown file in SHOW COLUMNS page.

- remove the unneeded embedded inline HTML markup by using the basic markdown syntax.
- use the ``` sql for highlighting the SQL syntax.

### Why are the changes needed?
Make the doc cleaner and easily editable by MD editors.

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

### How was this patch tested?
**Before**

![Screen Shot 2020-04-29 at 5 20 11 PM](https://user-images.githubusercontent.com/11567269/80661963-fa4d4a80-8a44-11ea-9dea-c43cda6de010.png)

**After**

![Screen Shot 2020-04-29 at 6 03 50 PM](https://user-images.githubusercontent.com/11567269/80661940-f15c7900-8a44-11ea-9943-a83e8d8618fb.png)

Closes #28414 from gatorsmile/cleanupShowColumns.

Lead-authored-by: Xiao Li <[email protected]>
Co-authored-by: gatorsmile <[email protected]>
Signed-off-by: gatorsmile <[email protected]>
(cherry picked from commit b5ecc41)
Signed-off-by: gatorsmile <[email protected]>
@gatorsmile
Copy link
Member Author

Thanks! Merged to master/3.0

srowen pushed a commit that referenced this pull request May 10, 2020
### What changes were proposed in this pull request?
Remove the unneeded embedded inline HTML markup by using the basic markdown syntax.
Please see #28414

### Why are the changes needed?
Make the doc cleaner and easily editable by MD editors.

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

### How was this patch tested?
Manually build and check

Closes #28451 from huaxingao/html_cleanup.

Authored-by: Huaxin Gao <[email protected]>
Signed-off-by: Sean Owen <[email protected]>
srowen pushed a commit that referenced this pull request May 10, 2020
### What changes were proposed in this pull request?
Remove the unneeded embedded inline HTML markup by using the basic markdown syntax.
Please see #28414

### Why are the changes needed?
Make the doc cleaner and easily editable by MD editors.

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

### How was this patch tested?
Manually build and check

Closes #28451 from huaxingao/html_cleanup.

Authored-by: Huaxin Gao <[email protected]>
Signed-off-by: Sean Owen <[email protected]>
(cherry picked from commit a75dc80)
Signed-off-by: Sean Owen <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants