Skip to content

Databases and SQL: Fix grammar and clarify SQL concepts #29611

New issue

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

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

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
May 26, 2025

Conversation

Maddily
Copy link
Contributor

@Maddily Maddily commented Apr 12, 2025

Because

The lesson had some grammar issues and unclear phrasing around certain SQL concepts. These edits aim to improve clarity, accuracy, and readability for learners.

This PR

  • Fixes grammar, punctuation, and sentence structure throughout the lesson
  • Clarifies when column names must be specified in INSERT INTO statements
  • Explains limited use of * in aggregate functions like COUNT(*) vs MAX(*). The "(because how would you MAX a column for "name"?)" part is removed because the issue isn’t really about the name column, but that MAX(*) doesn't make sense because MAX requires a specific type of column
  • Adds examples to support conceptual clarifications
  • Corrects "whole database" to "whole table"
  • Changes incorrect reference to the "HAVING function" to the correct term, "HAVING clause"

Issue

Closes #XXXXX

Additional Information

Pull Request Requirements

  • I have thoroughly read and understand The Odin Project curriculum contributing guide
  • The title of this PR follows the location of change: brief description of change format, e.g. Intro to HTML and CSS lesson: Fix link text
  • The Because section summarizes the reason for this PR
  • The This PR section has a bullet point list describing the changes in this PR
  • If this PR addresses an open issue, it is linked in the Issue section
  • If any lesson files are included in this PR, they have been previewed with the Markdown preview tool to ensure it is formatted correctly
  • If any lesson files are included in this PR, they follow the Layout Style Guide

Maddily added 5 commits April 12, 2025 14:53
The sentence, "If you just do an action on a table without specifying conditions, it will apply to the whole database and you’ll probably break something" mentions that the action is on a table. Hence, it would affect the table, not the whole database.
It's incorrectly referred to as a function, but `HAVING` is a clause.
@github-actions github-actions bot added the Content: Databases Involves the Databases course label Apr 12, 2025
Copy link
Contributor

@JoshDevHub JoshDevHub left a comment

Choose a reason for hiding this comment

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

Thank you for making all these changes. I have a few suggestions for ways to improve further. Let me know if you have any questions.

Maddily added 5 commits April 18, 2025 13:55
Revised explanation to mention that omitting column names is possible but discouraged, without showing an example.
The reference to `HAVING` was recently updated from "function" to "clause" and the id needed updating as well as the knowledge check link.
@Maddily
Copy link
Contributor Author

Maddily commented Apr 18, 2025

Done. Thank you for the suggestions. Let me know if you think any further modifications are needed.

@Maddily Maddily requested a review from JoshDevHub April 18, 2025 12:49
@JoshDevHub JoshDevHub merged commit 1724647 into TheOdinProject:main May 26, 2025
2 checks passed
@Maddily Maddily deleted the grammar-and-clarity branch May 27, 2025 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content: Databases Involves the Databases course
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants