Skip to content

Plan programming book chapters structure#32

Open
Slashmsu wants to merge 3 commits intomainfrom
claude/plan-book-chapters-01KuzodoAzgpnZyK4t6oYHRo
Open

Plan programming book chapters structure#32
Slashmsu wants to merge 3 commits intomainfrom
claude/plan-book-chapters-01KuzodoAzgpnZyK4t6oYHRo

Conversation

@Slashmsu
Copy link
Collaborator

🎉 Pull Request

Description

Type of Change

  • 🐛 Bug fix (non-breaking change which fixes an issue)
  • ✨ New feature (non-breaking change which adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality
    to not work as expected)
  • 📚 Documentation update
  • 🔧 Configuration/build changes
  • ✅ Test improvements
  • ♻️ Code refactoring (no functional changes)

Related Issue

Fixes #(issue number)

Changes Made

Testing

  • All existing tests pass (npm test)
  • Added new tests for the changes
  • Tested manually with examples
  • Linting passes (npm run lint)
  • Type checking passes (npm run type-check)

Checklist

  • My code follows the project's code style guidelines
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings or errors
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published

Additional Context


📋 License Information

SomonScript is open source software licensed under the MIT License.

By submitting this pull request, you agree that your contributions will be
licensed under the MIT License.

For contribution guidelines, please review:


Thank you for contributing to SomonScript! 🚀

Bakhtier Gaibulloev added 2 commits November 17, 2025 19:25
Created a complete programming book in Tajik (Cyrillic script) with 12 chapters:
- Chapter 1: Introduction to SomonScript
- Chapter 2: Language basics (variables, constants, data types)
- Chapter 3: Data types (primitive, special, complex types)
- Chapter 4: Operators and expressions
- Chapter 5: Control structures (if-else, loops, switch-case)
- Chapter 6: Functions (declarations, recursion, higher-order)
- Chapter 7: Objects and arrays
- Chapter 8: Classes and OOP (inheritance, interfaces, abstract classes)
- Chapter 9: Module system (import/export)
- Chapter 10: Type system (union, intersection, generics, utility types)
- Chapter 11: Error handling and exceptions
- Chapter 12: Practical examples (complete projects)

All code examples are exclusively in SomonScript. Each chapter includes:
- Detailed explanations in Tajik
- Progressive difficulty suitable for all skill levels
- Practical code examples
- Exercises for practice

Added README.md with navigation and table of contents.
…ions

Enhanced Chapter 1 (Introduction):
- Added detailed explanations of what programming is with real-life examples
- Expanded installation instructions with step-by-step guide
- Added 10+ code examples with expected outputs
- Included 5 practical exercises for beginners
- Added explanations of program structure and CLI commands

Enhanced Chapter 2 (Language Basics):
- Expanded from 8 to 22 detailed code examples
- Added real-world analogies for better understanding
- Included expected outputs for every example
- Added comprehensive coverage of variables, constants, and data types
- Expanded exercises from 4 to 8 practical tasks
- Added naming conventions and best practices
- Included type conversion examples

Both chapters now suitable for complete beginners with:
- Simple Tajik language throughout
- Progressive difficulty levels
- Practical, real-world scenarios
- Detailed comments in every example
- Clear expected outputs
@Slashmsu Slashmsu requested a review from ggulpari November 18, 2025 09:40
@Slashmsu Slashmsu self-assigned this Nov 18, 2025
@github-actions
Copy link

✅ Tests completed on Node.js 20.x: success

@sonarqubecloud
Copy link

@github-actions
Copy link

✅ Tests completed on Node.js 20.x: success

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.

1 participant