Author and share great documentation for your Swift packages and frameworks.

Posts under DocC tag

24 Posts
Sort by:
Post not yet marked as solved
0 Replies
735 Views
I'm trying to find a more efficient way to generate the Apple-style /// code comments in Xcode. Although I can use Cmd + Option + Enter to automatically generate ///, it's not as convenient when copying(press option to select specific area) and pasting code. Is there a more streamlined approach to generate these comments, especially when pasting existing code? It's convenient to generate doc with old /** */
Posted Last updated
.
Post not yet marked as solved
1 Replies
641 Views
Hello, everybody. I'm Mauricio Paternina, an aspiring iOS Developer from Colombia. I have a strong interest in translating the Apple Developer Documentation into Spanish for two reasons: on one hand, I'd be able to dive deeper into the documentation itself and cement my knowledge, and on another hand, non-English speakers will be able to navigate and consume the contents of the Documentation, thus, reaching a wider audience. I'm currently the owner/maintainer of an ongoing effort to translate The Swift Programming Language book into Spanish as well. You can check the live site at https://swiftbook.es/. The site has been accepted by The Swift.org Working Development Group as the "official" Spanish translation and it's currently linked on their website. Back to my initial point, I'd tried reaching out to all possible channels to get guidance on how to request or proceed with this, or at least to know if this is even possible/allowed by Apple and I've found myself with no other clue than posting here hoping to find some clarity. I'd like to thank you in advance for any help you might be able to provide. P.S. I used a random tag for the sake of compliance with the posting requirements.
Posted
by trsplms.
Last updated
.
Post not yet marked as solved
5 Replies
1.2k Views
I've been using Xcode and Objective-C for years, and rely heavily on the built-in documentation, which is for the most part good.There's an issue that's always bothered me. Today I was looking up a function called class_getName. I found its documentation page, and was also able to navigate to the page showing the overview of the runtime system, all of which is fine.When I typed "class_getName" into my program, the compiler immediately flagged it as an unknown symbol.I knew I probably had to include a header, but none of the documentation pages I looked at mentioned the name of the header file. I had to end up searching the internet for examples until I hit one that showed <objc/runtime.h> being imported.Why isn't this very small, simple and extremely useful bit of information included in the documentation?Frank
Posted
by flarosa.
Last updated
.
Post not yet marked as solved
2 Replies
686 Views
Hello, everyone. I'm new here, so I'm unsure if this is the right place for this inquiry. I'm Mauricio Paternina, a beginner iOS Developer, interested in bringing Swift Development closer to Spanish speakers. I created the site for the Spanish translation of The Swift Programming Language book (which can check here) and I'm interested in translating the Apple Developer Documentation if that's possible. I noticed that the site already has Korean and Chinese translations. Are those provided by Apple directly or by some Korean/Chinese community members? Is it even possible to consider an initiative to translate into Spanish? I appreciate any information you might be able to provide for me to guide through this initiative.
Posted
by trsplms.
Last updated
.