Website

[ichiriac]

This pull request delivers a comprehensive overhaul and improvement of the NormalJS documentation, focusing on clarity, accuracy, and usability for both developers and AI coding agents. The changes correct previously misleading patterns, introduce a task-oriented and example-rich structure, and reorganize navigation for better discoverability and learning progression.

Documentation Corrections:

• Corrected all documentation to show the proper NormalJS pattern for updating records: direct property modification instead of non-existent update() or save() methods, with explicit anti-pattern warnings and updated examples across all major docs.
• Updated all relevant files (.github/copilot-instructions.md, docs/index.md, docs/cookbook.md, docs/models.md) to remove incorrect usage and demonstrate the correct way to update, persist, and delete records.

Documentation Improvements:

• Enhanced documentation structure to be task-oriented and pattern-based, providing "How to" guides, DO/DON'T examples, complete runnable code, error prevention, and improved searchability with keywords and a reorganized sidebar.
• Expanded and improved .github/copilot-instructions.md, docs/index.md, docs/cookbook.md, and docs/models.md with richer examples, anti-patterns, and practical guidance for both developers and AI agents.
• Added migration guide keywords and improved discoverability for the Sequelize adoption guide.

Navigation and Organization:

• Reorganized the documentation sidebar in docs/assets/sidebars.js to introduce new categories (Getting Started, Core Concepts, Working with Data, Advanced Patterns, Reference, Migration Guides), improving logical flow and progressive learning.
• Moved and categorized the Sequelize adoption guide under "Migration Guides" for easier access.

Content Updates and Consistency:

• Overhauled docs/index.md to provide a detailed, step-by-step quick start, key features, common tasks, and advanced topics, ensuring all examples reflect the corrected patterns and best practices.
• Updated cross-references and links in documentation to reflect new file names and organization, ensuring consistency and ease of navigation.

Meta and Infrastructure:

• Updated the GitHub edit URL in docusaurus.config.js to reflect the new repository location.

These improvements ensure that both human developers and AI agents will follow the correct, idiomatic NormalJS patterns, avoid common pitfalls, and quickly find the information they need.