Skip to content

Add Manual DocC Documentation Publishing Workflow#370

Merged
MikeThorntonPayPal merged 5 commits intomainfrom
add-manual-docs-workflow
Feb 5, 2026
Merged

Add Manual DocC Documentation Publishing Workflow#370
MikeThorntonPayPal merged 5 commits intomainfrom
add-manual-docs-workflow

Conversation

@MikeThorntonPayPal
Copy link
Collaborator

@MikeThorntonPayPal MikeThorntonPayPal commented Feb 5, 2026

Summary

Adds comprehensive DocC documentation generation with both local development and
automated publishing workflows.

Changes

  1. Local Documentation Generation

    • New ci script for generating and serving docs locally
    • Commands: ./ci generate_docs and ./ci serve_docs
    • Updated .gitignore to exclude generated docs and archives
  2. DocC Visibility Control

    • Mark internal implementation types as private in documentation
    • Improves clarity by hiding types developers shouldn't directly use
    • Affects CorePayments, CardPayments, and PaymentButtons modules
  3. Manual Publishing Workflow

    • New publish-docs.yml workflow with three modes:
      • preview: Publishes docs to /preview path with preview badge
      • production: Publishes docs to main path
      • cleanup-preview: Removes preview documentation
    • Manually triggered via GitHub Actions UI

Usage

Local Development:

./ci generate_docs  # Generate documentation
./ci serve_docs     # View at http://localhost:8000/documentation/

Publishing (after merge):

  • Go to Actions → "Publish Documentation" → Run workflow → Select environment

Checklist

  • Added a changelog entry

Authors

List GitHub usernames for everyone who contributed to this pull request.

MikeThorntonPayPal and others added 2 commits February 5, 2026 11:36
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
MikeThorntonPayPal and others added 3 commits February 5, 2026 11:50
- Create ci script with commands to generate and serve docs locally
- Update .gitignore to exclude generated docs and archives

Usage:
  ./ci generate_docs  # Generate DocC reference documentation
  ./ci serve_docs     # Start local server to view docs

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add @_documentation(visibility: private) attribute to classes, structs, and enums that are internal implementation details and should not appear in public documentation. This improves the clarity of the generated DocC documentation by hiding types that developers should not directly use.

Changes:
- CorePayments: HTTPMethod, HTTPHeader, NetworkingError, WebAuthenticationSession, CorePaymentsError
- CardPayments: PaymentSource
- PaymentButtons: Coordinator

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Refactor to use shared ci script for doc generation instead of duplicating
the code in the GitHub Action workflow. This ensures consistency between
local and CI documentation generation and makes the code easier to maintain.

Changes:
- Update ci script to accept optional hosting base path parameter
- Simplify publish-docs.yml to call ./ci generate_docs
- Workflow only handles environment-specific logic (badges, publishing)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@MikeThorntonPayPal MikeThorntonPayPal changed the title Add manual documentation publishing workflow Add manual DocC Documentation Publishing Workflow Feb 5, 2026
@MikeThorntonPayPal MikeThorntonPayPal changed the title Add manual DocC Documentation Publishing Workflow Add Manual DocC Documentation Publishing Workflow Feb 5, 2026
@MikeThorntonPayPal MikeThorntonPayPal merged commit da287a4 into main Feb 5, 2026
4 checks passed
@MikeThorntonPayPal MikeThorntonPayPal deleted the add-manual-docs-workflow branch February 5, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants