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

Some usability questions

Ouverte
#4 0 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
25/100
Type d'issue
Fonctionnalité
Clarté
À clarifier
Activité
Calme
Stack technique
elixir, openapi
Domaine
api

Piste de recherche

Aucun fichier ni test n’est nommé. Commencez par cartographier les modules d’opérations et de schéma ainsi que le point d’entrée du flux SSE, puis divisez la demande en propositions aux périmètres distincts. La réalisation nécessiterait un design approuvé et des critères d’acceptation pour les réponses typées, la disposition des namespaces et les événements SSE orientés processus.

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

Description

Hey!

I have a project that use the OpenCode API, I have my own client layer but I came across your project and I was thinking on using it.

Here are some usability things that maybe you can think if you would like to have, I can help with PRs for them if you want.

  • Decode responses. Now the operations return plain maps, that's not great for usability, specially since open-api-generator creates structs for all of them, I think it would be great to return the correct structs. (The same for the events for example)

  • Maybe split the operations and schemas in different directories and namespaces (for example, one for sessions, one for projects, ...), example: https://github.com/aj-foster/open-api-github

  • For SSE, having a stream is great for simple cases, but what if I want to have more control? It would be great to have an option to send events into the current pid (or a specified one), without the stream resource, that way a parent process can monitor/trap exists, and when the connection closes it can decide what to do

Langage dominant
Elixir
Étoiles
14
Forks
1
Métriques de merge des PR
Aucune PR mergée en 30 j

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.

Issues similaires

Plus d'issues Elixir

Recevez les nouvelles issues par e-mail

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