Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Teach how Ace works and what sharing exposes on first run

Đang mở
  • Có gì không ổn?
#215 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
documentation, frontend

Hướng nghiên cứu

The payload names no source files, so start with docs/terms.md for the vocabulary and the README to see how the product is described now. Find the existing first-run and the sharing, channel and project controls in the app. The checklist defines what the copy must cover. Related work is #214 (the collaborator-invocation toggle) and #162 (non-Git folders), so check those before writing. Done means each checklist item appears in a short first-run sheet or inline on its control, in terms.md vocabulary.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

New users don't know how Ace works or what sharing exposes. Teach it in the product, not only in the README: a short first-run sheet plus inline copy on the controls, not a tour. Use the terms vocabulary.

Already done

  • Sharing toggle states what it grants (#243, #389): "Teammates can run commands as you on this machine, with Ace's macOS permissions such as Screen Recording." Cloud compute channels name the container instead (#422). Verified in study scenario 6.
  • Desktop tools toggle: its tooltip names owner and collaborator runs, and turning it off says shell still has Ace's macOS permissions (#380). A refused call tells the agent to ask the owner (#258).
  • Non-Git folders (#162): Cmd+O offers git init and explains that lanes are Git worktrees (#222, apps/app/src/open-project.tsx).
  • Where a channel lives is shown in channel details: Host, Hosted plus Workspace, or the cloud container (apps/app/src/placement.ts, channel.tsx, #422).

Remaining

  • First-run sheet that covers each of these in a line:
    • Your machine is the host. Channels and agents run on this Mac as you. Lanes are Git worktrees, not sandboxes.
    • Your tailnet is your team. Everyone on the tailnet running Ace can see your channels and their history. There are no Ace accounts or invitations. This was the least understood rule in the study (1/3, scenario 1).
    • Sharing gives teammates your machine. Teammates can invoke agents only when you turn agent access on. Desktop tools are a separate owner toggle.
    • Where a channel lives: local, a teammate's host, hosted, or cloud compute.
    • Projects vs. channels: Cmd+O adds a project; creating a channel is a separate action.
  • Say on the channel, or near the channel list, that tailnet teammates can see it. No in-app copy says this today.
  • Say that only the owner controls agent access and desktop tools, instead of leaving people to infer it from a disabled control (scenario 1).
  • Decide whether turning desktop tools on gets a confirmation like agent access does (scenario 7).
  • Re-run the scenario 1 explain-back after this ships. The baseline on 0.0.26 was 1/3 for visibility and 2/3 for everything else.

Part of #217's pre-Universe list.

Ngôn ngữ chính
TypeScript
Star
1
Fork
0
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

  • Không có Dockerfile hay tệp Docker Compose
  • Có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/ace2

Tất cả issue của githubnext/ace2

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.