Skip to content

[PR] Update documentation#271

Merged
SamTess merged 8 commits into
mainfrom
update-docs
Jun 28, 2025
Merged

[PR] Update documentation#271
SamTess merged 8 commits into
mainfrom
update-docs

Conversation

@SamTess

@SamTess SamTess commented Jun 28, 2025

Copy link
Copy Markdown
Owner

This pull request focuses on improving the release workflow and documentation for the Zappy project. It introduces changes to enhance clarity, add new features, and ensure consistency in the release process. The most significant updates include the translation of documentation to English, the addition of assets to release packages, and updates to the workflow and README to reflect these changes.

Documentation Updates:

  • .github/release-examples.md and .github/release-workflow.md: Translated the release workflow documentation and examples from French to English for broader accessibility. [1] [2]

  • .github/release-workflow.md: Added details about assets in release packages and clarified the technical operation of the workflow.

Workflow Enhancements:

  • .github/workflows/release.yml: Updated the release process to include 3D models, textures, and music assets in the release package. Added logic to handle missing assets gracefully. [1] [2]

README Update:

  • README.md: Updated the platform information to indicate Linux-only support and incremented the version badge to 4.0.0.

SamTess added 5 commits June 27, 2025 17:03
- Updated server documentation with modular architecture, communication protocols, and detailed data structures.
- Expanded DLLoader documentation to include advanced usage, error handling, and system extension guidelines.
- Revamped UI architecture documentation with design patterns, class hierarchy, and window interaction mechanisms.
- Created a comprehensive update summary to track changes across multiple documentation files.
- Translated and enhanced the GUI documentation, improving clarity and detail on components, rendering, and user interface architecture.
- Revised UI architecture documentation to include detailed design patterns, class hierarchy, and window responsibilities.
- Updated the update summary to reflect changes in documentation, including new sections and improvements in clarity and structure.
- Ensured consistency in terminology and formatting across all documentation files.
@SamTess SamTess self-assigned this Jun 28, 2025
@SamTess SamTess added the docs Documentation issues or updates label Jun 28, 2025

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 translates the project documentation from French to English, updates terminology and navigation, and refreshes version/platform badges.

  • Translate all key documentation files to English and refine content for clarity and consistency
  • Update README badges to Linux-only support and bump version to 4.0.0
  • Adjust navigation links and consolidate design‐patterns documentation

Reviewed Changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/ui_architecture.md Translated UI architecture doc to English and updated component descriptions
docs/src/Shared/DLLoader.md Translated DLLoader documentation and refined usage sections
docs/src/Server/server_documentation.md Translated server doc and reorganized modules and launch parameters
docs/src/GUI/gui_documentation.md Translated GUI documentation and updated component list
docs/src/AI/ai_documentation.md Translated AI documentation and expanded architecture details
docs/protocol_server_ai.md Translated server-AI protocol doc and updated commands table
docs/map_renderer_implementation.md Translated map renderer implementation doc
docs/libs/RaylibCPP/raylibcpp_documentation.md Translated and enhanced RaylibCPP documentation
docs/libs/RayGUICPP/rayguicpp_documentation.md Translated RayGUICPP documentation and patterns
docs/docusaurus/src/components/HomepageFeatures/styles.module.css Added CSS rules for default SVG icon sizing
docs/docusaurus/docs/architecture.md Updated core components diagram and details
docs/design_patterns_map_renderer.md Removed outdated map-renderer patterns doc
docs/design_patterns.md Added consolidated design-patterns documentation
docs/README.md Updated navigation links; bumped platform and version badges
README.md Updated platform badge to Linux-only and version to 4.0.0
.github/release-workflow.md Translated release workflow guide to English
.github/release-examples.md Translated release examples to English
Comments suppressed due to low confidence (2)

docs/ui_architecture.md:38

  • [nitpick] Consider simplifying the phrasing to "The Factory pattern is used to encapsulate the creation and management of different windows." to improve readability.
The Factory pattern is used sophisticatedly to encapsulate the creation and management of different windows. The `UIWindowFactory` class is responsible for:

docs/docusaurus/docs/architecture.md:55

  • Translate "Architecture Modulaire Avancée" to English, for example "Advanced Modular Architecture", to maintain consistency in the English documentation.
### 1. Game Server (C) - Architecture Modulaire Avancée

ctalneau
ctalneau previously approved these changes Jun 28, 2025
@ctalneau ctalneau self-requested a review June 28, 2025 16:46
@SamTess SamTess merged commit 87ffe18 into main Jun 28, 2025
10 checks passed
@SamTess SamTess deleted the update-docs branch June 28, 2025 17:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation issues or updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants