# \[Proposal\] SOAR-0015: Namespace-Based Types File Splitting

**URL:** <https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830>\
**Category:** Development\
**Tags:** openapi\
**Created:** [August 7, 2026, 11:07am UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830 "2026-08-07T11:07:40Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![beaumont](https://avatars.discourse-cdn.com/v4/letter/b/ed8c4c/32.png) [@beaumont](https://forums.swift.org/u/beaumont)\
**Post date:** [August 7, 2026, 11:07am UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/1 "2026-08-07T11:07:40Z")

</div>

Hi folks!

The proposal [SOAR-0015: Namespace-based file splitting](https://github.com/nac5504/swift-openapi-generator/blob/soar-0015/Sources/swift-openapi-generator/Documentation.docc/Proposals/SOAR-0015.md) for Swift OpenAPI Generator is now up and **In Review** :

The review period will run until **August 14** - please feel free to post your feedback either as a reply to this thread, or on the [pull request](https://github.com/apple/swift-openapi-generator/pull/930).

Credit to Nick Candello for his work putting this together.

Thanks!

cc @Honza_Dvorsky

---

<div class="post-metadata">

**Author:** ![Honza\_Dvorsky](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/honza_dvorsky/32/29867_2.png) [@Honza\_Dvorsky](https://forums.swift.org/u/Honza_Dvorsky)\
**Post date:** [August 10, 2026, 3:32pm UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/2 "2026-08-10T15:32:03Z")

</div>

+1 on the proposal, it's an API-stable change that appears to produce a pretty significant performance boost to debug build times, so I'm for us taking it.

---

<div class="post-metadata">

**Author:** ![MahdiBM](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/mahdibm/32/45271_2.png) [@MahdiBM](https://forums.swift.org/u/MahdiBM)\
**Post date:** [August 10, 2026, 6:11pm UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/3 "2026-08-10T18:11:08Z")

</div>

+1, Yes please!

Even with an understandable "Swift build system should just get better and build faster" attitude, the changes are still of value considering they organize the generated code for possibly when you need to take a peek at the code, which admittedly is not frequently, but does happen.  
Meanwhile I'll also take the build time improvements as I've lost hope in Swift build system getting significantly better in short or mid term (I still appreciate any inceremental imprvements or such that are being done to the build times).

---

<div class="post-metadata">

**Author:** ![Joseph\_Heck](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/joseph_heck/32/22369_2.png) [@Joseph\_Heck](https://forums.swift.org/u/Joseph_Heck)\
**Post date:** [August 10, 2026, 8:01pm UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/4 "2026-08-10T20:01:50Z")

</div>

Very much in favor - some very nice and convenient benchmarking against some big examples in that proposal as well. Thank you to Nick Candello for the extra work to show it off!

---

<div class="post-metadata">

**Author:** ![jpsim](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jpsim/32/3390_2.png) [@jpsim](https://forums.swift.org/u/jpsim)\
**Post date:** [August 11, 2026, 12:25pm UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/5 "2026-08-11T12:25:27Z")

</div>

I also support this change (with the disclaimer that I work with Nick). Our team at Ramp has been post-processing the generator output using SwiftSyntax to achieve similar results for almost two years now, so moving this into the generator itself is a nice win for us.

---

<div class="post-metadata">

**Author:** ![ptoffy](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/ptoffy/32/44481_2.png) [@ptoffy](https://forums.swift.org/u/ptoffy)\
**Post date:** [August 12, 2026, 8:21am UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/6 "2026-08-12T08:21:31Z")

</div>

Yes please!! At the moment, for huge specs, generated files become tens of thousands of lines long which are sometimes slow to even open, let alone search through and debug.

---

<div class="post-metadata">

**Author:** ![Honza\_Dvorsky](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/honza_dvorsky/32/29867_2.png) [@Honza\_Dvorsky](https://forums.swift.org/u/Honza_Dvorsky)\
**Post date:** [August 14, 2026, 12:17pm UTC](https://forums.swift.org/t/proposal-soar-0015-namespace-based-types-file-splitting/88830/7 "2026-08-14T12:17:09Z")

</div>

Hi all,

(temporarily taking over as release manager due to Si's OOO).

Thank you everyone for the feedback - it was broadly supportive, so this proposal is now **Ready for Implementation**.
