Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Some usability questions

Aperta
#4 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Stack tecnologico
elixir, openapi
Ambito
api

Direzione di ricerca

Non vengono indicati file o test. Inizia mappando i moduli delle operazioni e dello schema e il punto di ingresso dello stream SSE, quindi suddividi la richiesta in proposte con ambiti distinti. Per considerarlo completato sarebbero necessari un design concordato e criteri di accettazione per le risposte tipizzate, il layout dei namespace e gli eventi SSE diretti ai processi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Elixir
Stelle
14
Fork
1
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Issue simili

Altre issue su Elixir

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.