Skip to content

Add best practices section to README: effect-tsgo vs tsgo relationship #10

@schickling-assistant

Description

@schickling-assistant

The README should include a best practices section clarifying how effect-tsgo relates to the official tsgo and whether they should be used in parallel or one over the other.

Suggested content

  • Relationship: effect-tsgo is a superset of tsgo — it embeds a pinned version with a small patch set and adds the Effect language service on top
  • Usage guidance: Use effect-tsgo instead of tsgo, not alongside it. Running both produces duplicate diagnostics and degrades editor performance
  • Version pinning: Each release is built against a specific upstream tsgo commit (recorded in flake.nix). No need to track upstream releases separately
  • Upgrade guidance: Upgrade effect-tsgo when a new release includes upstream fixes or new Effect diagnostics you need

🤖 Created by Claude on behalf of @schickling

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions