Road to Beta

[qurbonzoda]

The primary focus of our current development is to promote the library from Alpha to Beta stability level. The implementation is already robust, with few bugs reported since its inception. However, some fundamental design choices need to be made before we finalize the library API design. Thus, we will focus on the following areas:

• [ ] Immutable vs. Persistent interfaces:
  • Decide whether to have both Immutable and Persistent sets of interfaces.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/1
  • Provide implementations of Immutable collections that are not persistent.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/62
• [ ] Naming:
  • Determine if member functions of persistent collections that return a new instance should use a different naming scheme.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/8
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/139
  • Consider shorter names for persistent collections.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/14
  • Review the library’s public API, specifically extension function names.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/65
• [ ] Providing static assurance of the underlying implementation:
  • Expose implementation classes.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/66
  • Expose ordered types.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/106
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/128
  • Prohibit custom implementations of Immutable and Persistent interfaces.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/147
• [ ] Feature parity with stdlib collections:
  • Resolve the issue of stdlib collection extensions for persistent collections.
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/10
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/12
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/123
    • https://github.com/Kotlin/kotlinx.collections.immutable/issues/181

[Sporking]

The grouping of these that is used above seems a bit strange. It seems to me that issues #62, #66, #147, and #10 are basically the same issue, but they are grouped in different categories. In each of these, people are requesting true implementations of statically checkable immutable collections (ones which can't be subclassed to be non-immutable).