Visual and content update to Github Pages

[Paul Lizer (paullizer)]

This is just editing the docs files for github pages, ive merged this work into the dev > staging > main because it was getting too far out of sync so now it builds off main instead of the pages-documentation branch

[Copilot]

Pull request overview

This PR refreshes the GitHub Pages documentation site to use a shared “showcase” visual layout (matching the latest-release styling), expands/rewrites a number of docs pages into the new format, and adds/updates UI regression coverage for the redesigned docs experience.

Changes:

• Introduces a new Jekyll showcase-page layout (hero, cards, optional prev/next nav, shared feature-image modal) and ensures the feature-image modal JS handles link clicks correctly.
• Migrates many docs pages (tutorials, how-to, reference, explanation, support) to the new showcase layout and content structure.
• Adds a Playwright UI test to validate key docs pages render at desktop/mobile breakpoints and that the features image modal opens.

Reviewed changes

Copilot reviewed 53 out of 60 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
ui_tests/test_docs_showcase_pages.py	Adds Playwright coverage for docs pages across viewports and validates feature-image modal behavior.
docs/_layouts/showcase-page.html	New shared docs “showcase” layout with hero, card styling, nav controls, and image modal.
docs/_layouts/latest-release-feature.html	Cache-busts latest-release.js include to ensure updated modal behavior ships.
docs/assets/js/latest-release.js	Prevents default click navigation so modal triggers don’t navigate away; sets modal image alt/title/caption.
docs/index.md	Reworks docs landing page into showcase layout and structured “start here” sections.
docs/features.md	Rewrites features page into structured showcase sections and adds modal image triggers for previews.
docs/faqs.md	Converts FAQ to showcase layout with collapsible sections and jump anchors.
docs/about.md	Converts About page to showcase layout with clearer navigation and positioning.
docs/admin_configuration.md	Converts admin configuration guide to showcase layout and new intro framing.
docs/application_workflows.md	Converts workflow docs to showcase layout and streamlines workflow narratives.
docs/application_scaling.md	Converts scaling guidance to showcase layout and simplifies scaling guidance presentation.
docs/demos.md	Converts demos page to showcase layout with embedded demo previews.
docs/external_apps_overview.md	Converts external apps overview to showcase layout and updates links to GitHub source.
docs/setup_instructions.md	Converts setup instructions page to showcase layout and reorganizes into “deployment options / prerequisites / next steps”.
docs/setup_instructions_manual.md	Converts manual setup page to showcase layout and adds overview cards.
docs/setup_instructions_special.md	Converts special setup scenarios page to showcase layout and adds overview cards.
docs/troubleshooting/troubleshooting.md	Converts troubleshooting page to showcase layout and improves Kusto query formatting and headings.
docs/tutorials/index.md	Converts tutorials index to showcase layout with card-based navigation.
docs/tutorials/getting_started.md	Converts tutorial 1 page to showcase layout with hero metadata + intro cards.
docs/tutorials/first_agent.md	Converts tutorial 2 page to showcase layout with hero metadata + intro cards.
docs/tutorials/uploading_documents.md	Converts tutorial 3 page to showcase layout with hero metadata + intro cards.
docs/tutorials/classifying_documents.md	Converts tutorial 4 page to showcase layout with hero metadata + intro cards.
docs/how-to/index.md	Adds how-to index page in showcase layout.
docs/how-to/add_documents.md	Adds “Add Documents” how-to page in showcase layout.
docs/how-to/create_agents.md	Adds “Create Agents” how-to page in showcase layout.
docs/how-to/use_managed_identity.md	Converts managed identity how-to to showcase layout and adds structured overview.
docs/how-to/upgrade_paths.md	Converts upgrade paths how-to to showcase layout and adds structured overview.
docs/how-to/scaling_on_azure.md	Converts scaling how-to to showcase layout and adds structured overview.
docs/how-to/docker_customization.md	Converts Docker customization how-to to showcase layout and updates intro framing.
docs/how-to/enterprise_networking.md	Converts enterprise networking how-to to showcase layout and adds structured overview.
docs/how-to/azure_speech_managed_identity_manul_setup.md	Converts Speech MI setup doc to showcase layout and expands overview.
docs/how-to/agents/ServiceNow/index.md	Adds ServiceNow how-to index page in showcase layout.
docs/how-to/agents/ServiceNow/SERVICENOW_INTEGRATION.md	Converts ServiceNow integration doc to showcase layout and fixes spacing in metadata line.
docs/how-to/agents/ServiceNow/SERVICENOW_OAUTH_SETUP.md	Converts ServiceNow OAuth setup doc to showcase layout.
docs/how-to/agents/ServiceNow/TWO_AGENT_SETUP.md	Converts ServiceNow two-agent doc to showcase layout.
docs/how-to/agents/ServiceNow/SERVICENOW_ASSET_MANAGEMENT_SETUP.md	Converts ServiceNow asset management setup doc to showcase layout.
docs/reference/deploy/index.md	Converts deploy reference index to showcase layout while retaining recommended order list.
docs/reference/deploy/azd-cli_deploy.md	Converts AZD deploy reference to showcase layout with stronger runtime-model framing.
docs/reference/deploy/azurecli_powershell_deploy.md	Converts Azure CLI + PowerShell deploy reference to showcase layout.
docs/reference/deploy/bicep_deploy.md	Converts Bicep deploy reference to showcase layout and refines workflow guidance.
docs/reference/deploy/terraform_deploy.md	Converts Terraform deploy reference to showcase layout and adds warning panel.
docs/reference/deploy/manual_deploy.md	Converts manual deploy notes reference to showcase layout and refines checklist formatting.
docs/reference/admin_configuration.md	Converts admin configuration reference to showcase layout with structured overview.
docs/reference/api_reference.md	Adds API reference page in showcase layout listing Swagger/OpenAPI endpoints.
docs/reference/features.md	Adds features reference page in showcase layout mapping features to dependencies and deeper docs.
docs/explanation/index.md	Converts explanation index to showcase layout with structured navigation.
docs/explanation/architecture.md	Converts architecture explanation page to showcase layout and adds overview cards.
docs/explanation/design_principles.md	Converts design principles page to showcase layout and adds overview cards.
docs/explanation/feature_guidance.md	Converts feature guidance page to showcase layout and adds rollout grouping table.
docs/explanation/running_simplechat_locally.md	Converts local runtime doc to showcase layout and updates doc version string.
docs/explanation/running_simplechat_azure_production.md	Converts Azure production runtime doc to showcase layout and updates doc version string.
docs/explanation/features/v0.241.006/AI_VOICE_CONVERSATIONS_SETUP_GUIDE.md	Adds feature doc page describing the AI Voice Conversations setup guide modal.
docs/explanation/fixes/v0.241.006/TABULAR_EXHAUSTIVE_RESULT_SYNTHESIS_FIX.md	Adds fix documentation page for tabular synthesis retry behavior.
docs/explanation/fixes/v0.241.006/TABULAR_RESULT_COVERAGE_REDUNDANT_COMPARISON_FIX.md	Adds fix documentation page for redundant comparisons cleanup.
docs/explanation/fixes/v0.241.006/SPEECH_VIDEO_INDEXER_GUIDANCE_FIX.md	Adds fix documentation page for multimedia setup guidance alignment.
docs/explanation/fixes/v0.241.006/SPEECH_RESOURCE_ID_BUILDER_FIX.md	Adds fix documentation page for Speech resource ID builder helper.
docs/explanation/fixes/v0.241.006/MEDIA_ENHANCED_CITATION_BADGE_FIX.md	Adds fix documentation page for media enhanced citation badge consistency.
docs/explanation/fixes/v0.241.006/GROUP_PROMPTS_ROLE_UI_NULL_GUARD_FIX.md	Adds fix documentation page for group prompts role UI null guarding.
docs/contributing.md	Adds a docs-site contributor guide in showcase layout (includes docs UI regression instructions).
CONTRIBUTING.md	Adds a root contributor guide aligned with the docs-site version.