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

Api documentation as json or interactively?

Aperta
#11 1 commento 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
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
json, openapi
Ambito
api, documentation

Direzione di ricerca

Inizia dalla documentazione dell’API collegata e dalla documentazione di TypeDoc sulla generazione di JSON; confronta l’endpoint .json proposto con l’alternativa Swagger/OpenAPI. Il lavoro sarà considerato completato quando sarà definito un approccio documentato e concordato per esporre moduli e metodi in una forma leggibile dalle macchine.

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

Descrizione

I checked out the api documentation and couldn't find a way to get the modules and methods in a machine readable way. However typedoc states that you can generate json from the comments.

Could we add json somehow, maybe for something like

https://plugins-doc.logseq.com/logseq/baseInfo

it could just be:

https://plugins-doc.logseq.com/logseq/baseInfo.json

An alternative could be something like swagger, which is for OpenApi-documented RESTful apis only. But maybe there exists something comparable for typedoc?!

Lingua principale
HTML
Stelle
26
Fork
8
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

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.

Altre issue di logseq/plugins

Tutte le issue di logseq/plugins

Issue simili

Altre issue su Backend & API Design

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.