Skip to content
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

docs: ✏️ build documentation with DocC and host on swiftpackageindex.com #613

Merged
merged 1 commit into from
Nov 16, 2023

Conversation

MarcoEidinger
Copy link
Member

FioriSwiftUI is currently accessible via the Swift Package Index (https://swiftpackageindex.com/SAP/cloud-sdk-ios-fiori).

This PR enhances our Swift Package Index experience by leveraging its auto-building and auto-hosting DocC feature to build and host the API Reference documentation for FioriThemeManager and FioriCharts .

Motivation

Give the API reference a facelift using Apple's Swift Documentation Compiler (DocC).

DocC offers a similar feature set like Jazzy but with a modern look, symbol search, platform availability indicators and theming options.

Changes

  • Add a .spi.yml file
    See SPI docs on how this auto-hosted, auto-generated docs works. It's really neat! We could even have this replace our hosted reference docs entirely 👀.
  • Add documentation catalogs (.docc) and respective material for a better generation result

Expected results

Screenshot 2023-11-15 at 9 13 28 AM

Screenshot 2023-11-15 at 9 11 31 AM

Future changes

Suppose the result is as expected and satisfying. Any Jazzy related information (e.g. overview pages, GitHub action to build Jazzy Doc and host as GitHub page, etc.) can be removed from the repository.

@MarcoEidinger MarcoEidinger requested a review from a team as a code owner November 15, 2023 17:32
@MarcoEidinger MarcoEidinger requested review from billzhou0223 and dyongxu and removed request for a team November 15, 2023 17:32
@MarcoEidinger MarcoEidinger merged commit d8a028c into main Nov 16, 2023
11 checks passed
@MarcoEidinger
Copy link
Member Author

MarcoEidinger added a commit that referenced this pull request Nov 17, 2023
* 'main' of github.com:SAP/cloud-sdk-ios-fiori:
  fix: 🐛 [bcp: 0] remove background in ObjectHeader (#614)
  docs: ✏️ build documentation with DocC and host on swiftpackageindex.com (#613)
  chore: 🤖 refactor FioriIcon and support accessing cgImage through Image (#612)
  feat: 🎸 jira 2286 sort & filter for SwiftUI project (#606)
  fix: 🐛 [bcp: 2370136916] fix width mode for DimensionSelector (#610)
  feat: [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  feat: [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  chore: 🤖 update CI job for watchOS to use xcode 15 (#609)
  chore: 🤖 run CI job on macos-13 and xcode 15.0 (#608)
  feat: [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  feat: [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  feat: 🎸 [JIRA: HCPSDKFIORIUIKIT-2224] New FioriButtonStyle support (#603)
  feat: 🎸 [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  feat: 🎸 [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
  feat: [JIRA: HCPSDKFIORIUIKIT-2444] Update to include more icons
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