It was mentioned in the Swift Student Challenge that outstanding winners will have the opportunity to visit Apple Park in the United States. However, as a challenger from China who is not currently in the U.S., this means that if I receive the outstanding award, I will need to apply for a visa to travel to Apple Park. Since I am under 18, my guardian would also need to apply for a visa. Therefore, I would like to know if Apple provides visa assistance for outstanding winners and their guardians from China, or if we are responsible for applying for the visas on our own.
DocC
RSS for tagAuthor and share great documentation for your Swift packages and frameworks.
Posts under DocC tag
11 Posts
Sort by:
Post
Replies
Boosts
Views
Activity
Hi all,
I am trying to use this guide to link directly to symbols in my documentation. But I am unable to get it to link to an Objective-C enum case. For example
``EnumNameType/EnumNameMyCase``
does not create a link. It works fine for method names, etc. I have tried all of the combinations I can think of, but I can't get it to work.
Any help is much appreciated!
The project setup is as follows:
Uses pods
Has swift bridging header as it uses both Objc and Swift
With Xcode Version 16.0 (16A242d), when building the project everything is fine but when I build the Documentation (Product > Build Documentation), I am getting this error via:
/.../Project/Pods/FirebaseCore/FirebaseCore/Sources/Public/FirebaseCore/FIRLoggerLevel.h:23:28: redefinition of 'FIRLoggerLevel'
...
Building the documentation of the same project with Xcode Version 15.4 works just fine, so the error must come from the new xcodebuild (Xcode 16.0 Build version 16A242d).
Here are the pods in the project:
pod 'Firebase/Crashlytics', '10.29.0'
pod 'Firebase/Performance', '10.29.0'
# (Recommended) Pod for Google Analytics
pod 'FirebaseAnalytics', '10.29.0'
pod 'GoogleAnalytics', '3.21'
pod 'GoogleTagManager', '7.4.3'
pod 'FirebaseRemoteConfig', '10.29.0'
pod 'GoogleUtilities', '7.13.0'
Tried with all latest, but the same issue persists.
Any ideas, on how to resolve this? I read that it is not possible to disable the pods being build by docc as they are dependencies of the target which is being build by the docc process, if that is not true, maybe I can disable docc from building the Pods.
Context
Hello everyone, I'm a freshly graduate engineer currently learning Swift and Apple ecosystem frameworks as I wish to become an Apple Developer / Engineer.
I made a very simple and light Swift package but I cannot build the documentation using DocC.
Issue
See my project here on github and explanations below.
Behavior
Building Documentation for my Swift package results in an empty page with only my Package name.
Adding a documentation catalog with a start page work but only the start page is displayed after building. None of my structs in any sources files appears in the built documentation.
Trying to add symbol linking to my sources files's structs in the start page (using double backquotes) results in the Topic section not built and a warning "MyStruct doesn't exist at '/MyPackage'"
What I tried
I found multiple information while looking for a solution, so I tried everything.
None of my structs / classes have the same name as the package
I did not remove the Topics section in the start page of the documentation catalog, neither I removed the Header 2 formatting.
My documentation catalog and my sources files lies within MyPackage/Sources/MyPackage/
I compared my starting page and folder architecture with the Sloth demo project
I did comment my structs / classes / functions with three slash /// using Xcode shortcut to pre-write documentation
Technical Specifications
macOS 14.5
MacBook Pro M3 Pro 18Go
Xcode Version 15.4 (15F31d)
swift-tools-version: 5.10
Images
Conclusion
I have no idea what else to do and if I am doing something wrong. Any feedback or solution on my issue would be really appreciated as I'm doing my best to learn the best practices to become an Apple developer.
Thank you.
if I want to document my color asset with DocC to help the development team use colors correctly in app development, how can I do it?
p.s. think about when you have to work in a team but there isn't a graphic repository, like Figma or Zeplin
I'm trying to figure out how to build DocC from other frameworks to Xcode's Developer Documentation.
I tried using the build documentation command, and it generates the DocC for my project and displays it in the Developer Documentation, but not libraries in the SPM.
The code documentation does appear in the Developer Documentation, but the contents of the DocC are not shown.
I am working on an sdk project and hope to find interface change information by comparing two doccarchive
Does anyone know of any documentation for the various directives in the guidebook?
Things like @GuideBook, @Guide, @Task, @SuccessMessage, etc.
Thanks,
David
How can I hide "App Frameworks" documentation? Seems like it's just cluttering my documentation, especially since I want to host on a website. O just want my imported documentation.
I want to hide this:
I have a workspace with my project and a Swift Macro. When I use the "Build Documentation" command the build fails with this error:
fatal error: module map file '/Users/me/Library/Developer/Xcode/DerivedData/Project-fmdkuqlofexbqdhhitpgjnoqzyrz/Build/Intermediates.noindex/GeneratedModuleMaps-iphoneos/Macros.modulemap' not found
Is there a way around this?
As presented in the talks and documentation I’ve seen so far, DocC works for public and open Swift symbols. But how about stuff for internal use?
We are developing a fairly complex mixed source SDK with several components, that would benefit greatly from direct integration of auxiliary content for diagrams and so on. But since many of these parts are for internal use only, they have module or below level visibility.
Is there a way to build an internal documentation target that includes this information with DocC, and — if so — how?