Skip to content

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

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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions