feat(core): Make ISpan startChild SpanOptions overloads public (#5927)

* feat(core): Make ISpan startChild SpanOptions overloads public

Unmark the SpanOptions-based startChild overloads on ISpan so callers
can set an explicit start timestamp without using internal API.

Co-Authored-By: Roman Zavarnitsyn <roman.zavarnitsyn@sentry.io>

* changelog

Co-Authored-By: Roman Zavarnitsyn <roman.zavarnitsyn@sentry.io>

---------

Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Roman Zavarnitsyn <roman.zavarnitsyn@sentry.io>

Author: sentry-junior[bot]

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+### Features
+
+- Make `ISpan.startChild` overloads with `SpanOptions` public ([#5927](https://github.com/getsentry/sentry-java/pull/5927))
+
 ### Fixes
 
 - Clear contexts when calling `Scope.clear()` ([#5902](https://github.com/getsentry/sentry-java/pull/5902))

sentry/src/main/java/io/sentry/ISpan.java

@@ -17,12 +17,25 @@ public interface ISpan {
   @NotNull
   ISpan startChild(@NotNull String operation);
 
-  @ApiStatus.Internal
+  /**
+   * Starts a child Span.
+   *
+   * @param operation - new span operation name
+   * @param description - new span description name
+   * @param spanOptions - options for the newly created span, e.g. an explicit start timestamp
+   * @return a new transaction span
+   */
   @NotNull
   ISpan startChild(
       @NotNull String operation, @Nullable String description, @NotNull SpanOptions spanOptions);
 
-  @ApiStatus.Internal
+  /**
+   * Starts a child Span.
+   *
+   * @param spanContext - the context for the newly created span
+   * @param spanOptions - options for the newly created span, e.g. an explicit start timestamp
+   * @return a new transaction span
+   */
   @NotNull
   ISpan startChild(@NotNull SpanContext spanContext, @NotNull SpanOptions spanOptions);