[New Entry] SQL Commands: SELECT TOP

[jmpos7]

Description

Adding a basic new entry for the TOP command, which did not have an entry. Adding to the Codecademy documentation is a project in the Learn Git & GitHub course and I wanted to make a contribution.

Closes #1303

Type of Change

• Adding a new entry
• Updating the documentation

Checklist

• All writings are my own.
• My entry follows the Codecademy Docs style guide.
• My changes generate no new warnings.
• I have performed a self-review of my own writing and code.
• I have checked my entry and corrected any misspellings.
• I have made corresponding changes to the documentation if needed.
• I have confirmed my changes are not being pushed from my forked main branch.
• I have confirmed that I'm pushing from a new branch named after the changes I'm making.
• Under "Development" on the right, I have linked any issues that are relevant to this PR (write "Closes # in the "Description" above).

[CLAassistant]

All committers have signed the CLA.

[SSwiniarski]

@jmpos7, thanks for your contribution. Please remember to sign the CLA.

[Dusch4593]

Hi @jmpos7, wanted to also confirm that this pull request aims to fix issue #1303?

[jmpos7]

@Dusch4593 Confirmed

[Dusch4593]

@jmpos7 awesome thanks! And double-thanks for signing the CLA 👍🏻

[SSwiniarski]

@jmpos7 , I did a first review and left one comment to address.

[SSwiniarski]

The syntax section needs a few changes:

• The examples should be in a ```pseudo block.
• The examples should be generalized, such as SELECT TOP (n) SELECT TOP (n) PERCENT
• Each example should have an explanatory sentence describing what it's doing and what n is.

[Dusch4593]

I would also include a sentence in the "Syntax" section that explains how column_name(s) is a space-separated list of existing columns that are selected from table_name.

[Dusch4593]

Hey @jmpos7! 👋🏻 Did you have any questions about or need any assistance with implementing the feedback?

[jmpos7]

@Dusch4593 Thanks for checking in -- I made the reviewer recommended changes to the document. What is the next step?

[SSwiniarski]

@jmpos7 I had two more minor changes, but otherwise looks good for a second review.

[Dusch4593]

@jmpos7 Left you some comments/suggestions but I may have more after this current feedback is implemented. 😄

[Dusch4593]

I'm wondering if this entry should be repurposed as a concept entry and renamed as 'SELECT TOP' (similar to the existing SELECT DISTINCT entry).

cc: @SSwiniarski

[Dusch4593]

I would also include a sentence in the "Syntax" section that explains how column_name(s) is a space-separated list of existing columns that are selected from table_name.

@Dusch4593 is no longer a maintainer on this repro.

[SSwiniarski]

@jmpos7 because there's been over two weeks of inactivity, an In the interests of merging this PR, I went ahead an committed all of @Dusch4593's suggestions.

[github-actions]

👋 @jmpos7
You have contributed to Codecademy Docs, and we would like to know more about you and your experience.
Please take a minute to fill out this four question survey to help us better understand Docs contributions and how we can improve the experience for you and our learners.
Thank you for your help!

[SSwiniarski]

Congrats @jmpos7! Your new entry is live here: https://www.codecademy.com/resources/docs/sql/commands/select-top

It looks like you're currently anonymous.

If you'd like to become public, make sure to add your GitHub username to your Codecademy profile and set your visibility to everyone.