Skip to content

[EDU-6373] API v4 change rollout for 26 guides #1799

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 5 commits into from
Closed

Conversation

mrmessa
Copy link
Contributor

@mrmessa mrmessa commented Aug 12, 2025

This commit implements the complete API v4 rollout documentation structure across all critical user journeys, supporting both legacy (API v3/Domains) and new (API v4/Workloads) interfaces during the migration period.

Key changes:

  • Added Apiv4Rollout component and 4-tab structure (Console-Workloads, Console-Domains, API v4, API v3) to 26+ guides
  • Implemented Workloads interface support for mTLS, certificates, cache settings, and error responses
  • Added Edge Connectors documentation, replacing Origins and Load Balancers
  • Implemented Custom Pages, replacing Error Responses witha proper 3-tab structure
  • Added comprehensive API v4 endpoints with proper authentication and request bodies
  • Verified all API v3 endpoints use the correct base URL (api.azionapi.net) and headers
  • Fixed endpoint error in cache-settings.mdx during final sweep
  • Added critical operation guides: clone, delete, and personal-token management
  • Maintained bilingual consistency across EN/PT-BR documentation

Architectural concepts covered:

  • Workloads (aggregated TLS/mTLS configuration replacing individual domain management)
  • Edge Connectors (unified origin and load balancer replacement)
  • Custom Pages (modernized error response handling)
  • Let's Encrypt HTTP-01 challenge automation in API v4
  • Data Stream workload association replacing domain-based configuration

This ensures users at any migration stage have clear, accurate documentation for their preferred interface while maintaining technical accuracy across all endpoints and authentication methods.

🤖 Powered by AI

…cal user guides

This commit implements the complete API v4 rollout documentation structure across all critical user journeys, supporting both legacy (API v3/Domains) and new (API v4/Workloads) interfaces during the migration period.

Key changes:
- Added Apiv4Rollout component and 4-tab structure (Console-Workloads, Console-Domains, API v4, API v3) to 26+ guides
- Implemented Workloads interface support for mTLS, certificates, cache settings, and error responses
- Added Edge Connectors documentation replacing Origins and Load Balancers
- Implemented Custom Pages replacing Error Responses with proper 3-tab structure
- Added comprehensive API v4 endpoints with proper authentication and request bodies
- Verified all API v3 endpoints use correct base URL (api.azionapi.net) and headers
- Fixed endpoint error in cache-settings.mdx during final sweep
- Added critical operation guides: clone, delete, and personal-token management
- Maintained bilingual consistency across EN/PT-BR documentation

Architectural concepts covered:
- Workloads (aggregated TLS/mTLS configuration replacing individual domain management)
- Edge Connectors (unified origin and load balancer replacement)
- Custom Pages (modernized error response handling)
- Let's Encrypt HTTP-01 challenge automation in API v4
- Data Stream workload association replacing domain-based configuration

This ensures users at any migration stage have clear, accurate documentation for their preferred interface while maintaining technical accuracy across all endpoints and authentication methods.

🤖 Powered by AI
@mrmessa mrmessa requested a review from a team as a code owner August 12, 2025 18:20
@mrmessa mrmessa requested a review from LuizaVSantos August 12, 2025 18:20
@LuizaVSantos LuizaVSantos added the do not merge Waiting for decision or deploy label Aug 12, 2025
…cal user guides

This commit implements the complete API v4 rollout documentation structure across all critical user journeys, supporting both legacy (API v3/Domains) and new (API v4/Workloads) interfaces during the migration period.

Key changes:
- Added Apiv4Rollout component and 4-tab structure (Console-Workloads, Console-Domains, API v4, API v3) to 26+ guides
- Implemented Workloads interface support for mTLS, certificates, cache settings, and error responses
- Added Edge Connectors documentation replacing Origins and Load Balancers
- Implemented Custom Pages replacing Error Responses with proper 3-tab structure
- Added comprehensive API v4 endpoints with proper authentication and request bodies
- Verified all API v3 endpoints use correct base URL (api.azionapi.net) and headers
- Fixed endpoint error in cache-settings.mdx during final sweep
- Added critical operation guides: clone, delete, and personal-token management
- Maintained bilingual consistency across EN/PT-BR documentation

Architectural concepts covered:
- Workloads (aggregated TLS/mTLS configuration replacing individual domain management)
- Edge Connectors (unified origin and load balancer replacement)
- Custom Pages (modernized error response handling)
- Let's Encrypt HTTP-01 challenge automation in API v4
- Data Stream workload association replacing domain-based configuration

This ensures users at any migration stage have clear, accurate documentation for their preferred interface while maintaining technical accuracy across all endpoints and authentication methods.

🤖 Powered by AI
… errors

This commit addresses systematic issues in the API v4 rollout documentation:

## Major Architectural Corrections:
- Fix Cache Settings location: remains under Edge Application, not Workloads
- Fix Rules Engine location: remains under Edge Application, not Workloads
- Fix Let's Encrypt configuration: done through workload interface, not dropdown
- Correct Edge Connector types: use "http" instead of fabricated "origin" type

## API Endpoint Corrections:
- Remove fabricated API v4 domains endpoints (v4 uses workloads only)
- Remove non-existent edge application clone endpoints (v3/v4)
- Remove fabricated template deployment endpoints
- Fix Edge SQL/Storage: v4-only products, remove v3 references

## MDX Syntax Fixes:
- Fix malformed Fragment tags causing build failures
- Correct host variable escaping in code blocks
- Remove extra closing Fragment tags

## Files Modified:
- 21 documentation files across EN/PT-BR
- Focus on build-journey, guides, and reference sections
- Systematic corrections based on actual v4 architecture

🤖 Powered by AI
…tency

## Architectural Corrections:
- Remove incorrect guidance about using "Domains interface" for edge application cloning
- Fix edge application cloning to direct users to Edge Application interface
- Correct Edge Connector type from "Origin" to "HTTP" type in PT-BR

## EN/PT-BR Consistency:
- Add tab structure to PT-BR clone guide to match EN version
- Ensure consistent messaging across both languages
- Add API v4 rollout snippets and migration guidance

## Files Modified:
- EN: ea-clone-edge-application.mdx - Fixed incorrect architectural guidance
- PT-BR: multiple-origins.mdx - Fixed Edge Connector types
- PT-BR: ea-clone-edge-application.mdx - Added equivalent structure

🤖 Powered by AI
@mrmessa mrmessa requested a review from a team as a code owner August 14, 2025 18:41
@mrmessa mrmessa force-pushed the v4-mrm-updates branch 2 times, most recently from 265a04d to 3f11836 Compare August 15, 2025 17:18
Keep corrected Edge Connector types (http not origin), proper Edge Application interface guidance for cloning, Cache Settings under Edge Applications, and accurate Let's Encrypt configuration through workload interface.

🤖 Powered by AI
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not merge Waiting for decision or deploy
Development

Successfully merging this pull request may close these issues.

2 participants