Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

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

Ouverte
  • Quelque chose ne va pas ?
#321 9 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
15/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
c
Domaine
desktop-dev, documentation

Piste de recherche

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.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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).

Langage dominant
C
Étoiles
10
Forks
8
Merge moyen
21 min
PR mergées (30 j)
1

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de FriendsofECCE/ECCE

Toutes les issues de FriendsofECCE/ECCE

Issues similaires

Plus d'issues C

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.