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

Discoverability: first steps a new user has to be told about

Đang mở
  • Có gì không ổn?
#321 9 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
15/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ệ
c
Lĩnh vực
desktop-dev, documentation

Hướng nghiên cứu

Start from the Help menu entry "on Organizer…", the File menu that changes with tree selection, the right-click menu on "Local data", and the New Calculation code choice, since the issue names these as the places to change. The help index holds the "Running codes" pages the issue wants linked, and the Help → Support diagnostics zip is the item to surface. The issue is a set of six discoverability changes with no agreed design yet, so it needs maintainer decisions before code work. Done means each step is either implemented or split into its own issue.

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

Mô tả

Collected from the first-use instructions written for a new macOS (Apple silicon) tester of 9.1.0. Each step below had to be explained in prose because the program does not lead to it. Discoverability and bug fixes are the focus of the next releases; reports from testers will be added here or filed separately.

Steps that needed explaining

  1. Help → "on Organizer…" is the entry point for all of the help, including the platform pages, but its label suggests a page about the Organizer only. Rename it (e.g. "ECCE Help") and keep Ctrl+H.
  2. Running other codes. After a local start only ECCE-QM is available. How to get ORCA, NWChem etc. is in "Running codes on macOS" (and the Linux/Windows equivalents), reachable only through the help index. The program should point there when a user looks for a code that is not set up (e.g. from New Calculation's code choice, or a Help menu entry "Running codes on this computer").
  3. Register Machines is under Tools, where a new user does not look for the place to make a code available. Link it from the same places as item 2.
  4. Creating a project or calculation is offered on right-click of "Local data" and in a File menu that changes with the tree selection. With nothing selected there is no visible way to start. Offer New Project / New Calculation in the File menu regardless of selection (defaulting to Local data), and say that a project is a folder.
  5. Example calculations. File → Open Example Calculations is the quickest way to see what ECCE does, but nothing suggests it. Import the examples automatically on the first start, into their own project ("Examples"), and record that this was done, so that deleting them does not bring them back. Applies to every deployment mode (each user's own data on a central server). File → Open Example Calculations stays, to restore them.
  6. Help → Support builds the diagnostics zip for a ticket; testers need to be told it exists. Mention it in the help start page and in error dialogs that ask the user to report a problem.

Related: #219 (help rewrite), #264 (first-calculation walkthroughs), #240 (first start).

Ngôn ngữ chính
C
Star
10
Fork
8
Merge trung bình
21 phút
Pull request đã merge (30 ngày)
1

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 FriendsofECCE/ECCE

Tất cả issue của FriendsofECCE/ECCE

Issue tương tự

Thêm issue về C

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.