Bump version to 0.0.7 and enhance documentation and API clarity

[qian-o]

This pull request focuses on improving documentation clarity, updating backend/version references, refining issue templates, and enhancing the website's user experience. The most significant changes include standardizing the naming and versioning of supported graphics APIs (DirectX 12, Metal 4, Vulkan 1.4), updating platform support information, simplifying issue templates, and improving the documentation site's layout and search functionality.

Documentation and Branding Updates:

• Updated all references to supported graphics APIs to specify "DirectX 12", "Metal 4", and "Vulkan 1.4" for clarity and consistency across README.md, documentation index files, and landing pages. This includes feature lists, overviews, and API reference tables. [1] [2] [3] [4] [5] [6] [7] [8]
• Added a new "Design Philosophy" section to the documentation, outlining the rationale for backend/API version choices and platform support strategies.
• Updated platform support tables to reflect accurate backend/platform combinations and removed outdated/incomplete status indicators. [1] [2]

Issue Template and Community Process Improvements:

• Simplified the bug report template by combining "Steps to reproduce" and "Expected behavior" into the main bug description, streamlining the reporting process.
• Removed the "General Issue" custom template and the "Feature Discussions" contact link to focus on more specific issue types and encourage use of Discussions for open-ended topics. [1] [2]

Documentation Site Enhancements:

• Improved the main documentation site's layout with a full-width container, better table cell formatting, and enhanced navbar/search styling for a more modern and readable experience. (F7fdbe87L6R6, [1] [2] [3]
• Added custom styling and logic for search results, including better navigation and back button support for in-site search. [1] [2] [3]
• Configured the documentation generator (docfx.json) to sort enums by declaration order, enable search, and generate a sitemap for improved SEO and usability. [1] [2]

These changes collectively enhance the professionalism, usability, and clarity of the Zenith.NET documentation and community processes.

[Copilot]

Pull request overview

This PR bumps Zenith.NET to v0.0.7 and refreshes project-facing documentation/UX to more clearly communicate backend/API targets (DirectX 12, Metal 4, Vulkan 1.4), platform support, and improve the generated docs site experience (layout + search).

Changes:

• Version bump to 0.0.7 and updated/standardized backend naming across docs/landing pages.
• Documentation site improvements (DocFX config, CSS layout tweaks, and enhanced in-site search behavior).
• Community process updates (simplified issue templates) and Vulkan-on-Apple enablement work (MoltenVK native dependency).

Reviewed changes

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

Show a summary per file

File	Description
sources/Zenith.NET.Vulkan/Zenith.NET.Vulkan.csproj	Adds MoltenVK native dependency for Vulkan-on-Apple scenarios.
sources/Directory.Packages.props	Central package version entry for Silk.NET.MoltenVK.Native.
sources/NuGet.Packaging.props	Bumps package version to 0.0.7.
sources/Experiments/CornellBox/App.cs	Adjusts OS→backend/surface selection (Windows DX12, macOS Metal, otherwise Vulkan).
sources/Experiments/CornellBox/CONVENTIONS.md	Updates backend naming/order in CornellBox conventions.
README.md	Standardizes backend/version naming and updates platform support table.
documents/index.md	Landing page copy updated to new backend/version naming and platform ordering.
documents/docs/index.md	Adds “Design Philosophy” section and refreshes platform support table headings.
documents/docs/concepts/graphics-context.md	Updates backend naming/version wording for consistency.
documents/api/index.md	Clarifies backend versioning in API namespace table descriptions.
documents/tutorials/index.md	Reorders desktop platform listing for consistency.
documents/tutorials/getting-started/prerequisites.md	Updates platform/backend selection narrative and reorganizes some tutorial content.
documents/tutorials/advanced/ray-tracing.md	Fixes/clarifies ray query sphere intersection snippet variables.
documents/docfx.json	Enables search, adds sitemap config, and sets enum sort order to declaring order.
documents/templates/public/main.css	Improves docs layout (full-width), table formatting, and search results styling.
documents/templates/public/main.js	Adds table-cell nowrap behavior and custom search navigation/back behavior.
.github/ISSUE_TEMPLATE/bug_report.yaml	Simplifies bug report fields and guidance text.
.github/ISSUE_TEMPLATE/config.yml	Removes “Feature Discussions” link and tidies contact links.
.github/ISSUE_TEMPLATE/custom.yaml	Removes the “General Issue” template.

Comments suppressed due to low confidence (1)

.github/ISSUE_TEMPLATE/bug_report.yaml:37

• The environment placeholder still references "DirectX12 / Metal / Vulkan" and a hardcoded "Zenith.NET Version: 1.0.0". This conflicts with the repo’s standardized API naming (DirectX 12 / Metal 4 / Vulkan 1.4) and the current package version (0.0.7). Updating these placeholders will reduce confusion in incoming bug reports.

      placeholder: |
        - OS: Windows 11 / macOS 15 / Ubuntu 24.04 / etc.
        - Graphics API: DirectX12 / Metal / Vulkan
        - Zenith.NET Version: 1.0.0
        - GPU: NVIDIA RTX 4090 / Apple M3 / etc.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[qian-o]

1