I finally realized that you can run "make docs" locally and that generates a StytchCore.doccarchive within the repo directory locally at: stytch-ios/.build/Build/Products/Release-iphoneos/StytchCore.doccarchive
If you double click that file it will open in Xcode as a whole documentation set.
If some of the links are broken that you define from the StytchCore.md from within Xcode, you must check their symbol.
You will notice that the links hav something like: StytchClient/OAuth-swift.struct/ThirdParty/start(configuration:)-75pid but that last part for -75pid doesn't always autocomplete. But you can find that symbol.
If you open stytch-ios/.build/Build/Products/Release-iphoneos/StytchCore.doccarchive/index/index.json you can find that symbol extension in there and append it to the text in StytchCore.md.
Checklist:
[x] I have verified that this change works in the relevant demo app, or N/A
[x] I have added or updated any tests relevant to this change, or N/A
[x] I have updated any relevant README files for this change, or N/A
Linear Ticket: [SDK-2024] [iOS] Broken Links in docs homepage.
Changes:
StytchCore.doccarchive
within the repo directory locally at:stytch-ios/.build/Build/Products/Release-iphoneos/StytchCore.doccarchive
StytchCore.md
from within Xcode, you must check their symbol.StytchClient/OAuth-swift.struct/ThirdParty/start(configuration:)-75pid
but that last part for-75pid
doesn't always autocomplete. But you can find that symbol.stytch-ios/.build/Build/Products/Release-iphoneos/StytchCore.doccarchive/index/index.json
you can find that symbol extension in there and append it to the text inStytchCore.md
.Checklist: