Skip to content

calm-hub: doc/naming accuracy cleanup in GitHub-mode classes #3088

Description

@jpgough-ms

Two unrelated doc/naming nits, grouped since neither has a functional fix and both are low priority.

  1. GitHubCloneManager's javadoc claims parallel cloning; cloneAll() is sequential. Plain for loop over namespaceRepos.entrySet(). Misleading, and a real startup-latency issue past a handful of namespaces.
  2. GitHubWriteNotSupportedException is also thrown from read-path/admin-listing methods in GitHubUserAccessStore where the failure isn't "you tried to write" but "this operation has no meaning in GitHub mode". Message text is accurate at each site — cosmetic, not a correctness bug.

Fix: for 1, fix the javadoc or make cloneAll() genuinely parallel (reuse the ManagedExecutor GitHubStartupInitializer already has). For 2, rename to something more general (GitHubOperationNotSupportedException) or add a second exception type for the non-write cases.

(Surfaced during #3066's review.)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    calm-hubAffects `calm-hub`

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions