Skip to content

updating - intro-sql and sql-setup-env #238

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

meetoza30
Copy link

Description

Improved SQL documentation with grammar fixes, clearer explanations, and consistent formatting. Enhanced the setup environment guide with step-by-step installation instructions, better IDE overview, and corrected technical details for a smoother learning experience.

Fixes #237

Type of Change

  • New feature (e.g., new page, component, or functionality)
  • Bug fix (non-breaking change that fixes an issue)
  • UI/UX improvement (design, layout, or styling updates)
  • Performance optimization (e.g., code splitting, caching)
  • [o] Documentation update (README, contribution guidelines, etc.)
  • Other (please specify):

Changes Made

Spelling and Grammar Fixes: Corrected all mistakes (e.g., “Itegrated developement enviornment” → “Integrated Development Environment”).

Clarified Purpose: Explained why beginners should install MySQL Server and Workbench locally versus just using online tools.

Clear Installation Steps: Provided simplified, step-by-step instructions for downloading and installing MySQL Server and Workbench, with OS-specific links. IDE Explanation: Improved the explanation about what an IDE is, its key features, and why it’s useful for database work.

Professional Tone: Removed informal language and filler content; added relatable analogies in a concise manner. Expanded Features List: More clearly outlined important IDE functionalities such as syntax highlighting, database visualization, query execution, debugging, and performance monitoring.

Grammatical corrections throughout, including spelling ("Manupulation" → "Manipulation", "dont" → "don't", etc.).

Section/heading normalization for readability and visual clarity. Rewrote the history and limitations of Excel/Access and clarified DBMS adoption.

Clarified the difference between SQL/NoSQL databases and corrected technical inaccuracies. Corrected and defined "Schema" to match industry standards.

Fixed all references of "SAQl" to "SQL". Applied consistent inline code formatting (SELECT) to all keywords in explanations and examples.

Dependencies

Updated the dependencies related to docusaurus - to the latest version of 3.8.1

Checklist

  • [o] My code follows the style guidelines of this project.
  • [o] I have tested my changes across major browsers/devices
  • [o] My changes do not generate new console warnings or errors , I ran npm run build and attached scrrenshot in this PR.
  • [] This is already assigned Issue to me, not an unassigned issue.

Copy link

vercel bot commented Jul 30, 2025

@meetoza30 is attempting to deploy a commit to the recode Team on Vercel.

A member of the Team first needs to authorize it.

Copy link

Thank you for submitting your pull request! 🙌 We'll review it as soon as possible. The estimated time for response is 5–8 hrs.

In the meantime, please provide all necessary screenshots and make sure you run - npm build run , command and provide a screenshot, a video recording, or an image of the update you made below, which helps speed up the review and assignment. If you have questions, reach out to LinkedIn. Your contributions are highly appreciated!😊

Note: I maintain the repo issue every day twice at 8:00 AM IST and 9:00 PM IST. If your PR goes stale for more than one day, you can tag and comment on this same issue by tagging @sanjay-kv.

We are here to help you on this journey of open source. Consistent 20 contributions are eligible for sponsorship 💰

🎁 check our list of amazing people we sponsored so far: GitHub Sponsorship. ✨

📚Your perks for contribution to this community 👇🏻

  1. Get free Consultation use code recode50 to get free: Mentorship for free.

  2. Get the Ebook for free use code recode at checkout: Data Science cheatsheet for Beginners.

  3. Check out this weekly Newsletter: Sanjay's Newsletter.

If there are any specific instructions or feedback regarding your PR, we'll provide them here. Thanks again for your contribution! 😊

@meetoza30
Copy link
Author

@sanjay-kv pls have a look!

@sanjay-kv
Copy link
Member

@meetoza30 i forgot to tell you this branch have conflicts could you fix it

Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR improves SQL documentation with comprehensive grammar fixes, clearer explanations, and consistent formatting. The changes focus on enhancing the learning experience for SQL beginners through better structure and technical accuracy.

  • Grammar and spelling corrections throughout SQL documentation files
  • Improved explanations of SQL concepts, IDE features, and setup instructions
  • Updated Docusaurus dependencies to version 3.8.1 for consistency

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 7 comments.

File Description
package.json Updates all Docusaurus dependencies to consistent version 3.8.1
docs/sql/setup-environment.md Enhances setup guide with clearer instructions, better IDE explanations, and grammar fixes
docs/sql/intro-sql.md Corrects spelling errors, improves SQL concept explanations, and standardizes code formatting

-- Delete a record
DELETE FROM Students WHERE ID = 1;

text
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper SQL syntax highlighting (```sql).

Suggested change
text

Copilot uses AI. Check for mistakes.

-- After deleting the record:
(No rows returned)

text
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper syntax highlighting (```plaintext).

Suggested change
text

Copilot uses AI. Check for mistakes.

Comment on lines +137 to +140

text
</TabItem>
<TabItem value="DML">
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper SQL syntax highlighting (```sql).

Suggested change
text
</TabItem>
<TabItem value="DML">
```sql ```

Copilot uses AI. Check for mistakes.

Comment on lines +150 to +157
text
</TabItem>
<TabItem value="DCL">
-- CREATE USER and GRANT statements (syntax may vary by DBMS)
CREATE USER 'new_user' IDENTIFIED BY 'password';
GRANT SELECT, INSERT, UPDATE ON customers TO new_user;

text
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper SQL syntax highlighting (```sql).

Copilot uses AI. Check for mistakes.

CREATE USER 'new_user' IDENTIFIED BY 'password';
GRANT SELECT, INSERT, UPDATE ON customers TO new_user;

text
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper SQL syntax highlighting (```sql).

Suggested change
text

Copilot uses AI. Check for mistakes.

-- ROLLBACK statement to undo changes made during a transaction
ROLLBACK;

text
Copy link
Preview

Copilot AI Aug 5, 2025

Choose a reason for hiding this comment

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

The 'text' placeholder appears to be unintentional and should be removed or replaced with proper SQL syntax highlighting (```sql).

Suggested change
text

Copilot uses AI. Check for mistakes.

@meetoza30
Copy link
Author

@sanjay-kv there were some docusaurus dependencies issue, ive resolved the conflict, pls have a look!

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.

📝[Docs]: Fixes needed in the SQL documentation on the website
2 participants