schemedoc / api.scheme.org

Web server for the Scheme API
1 stars 1 forks source link

Remote debug tool or extend the style of homepage for http://api.call-cc.org for all scheme implemantions with srfi #1

Open APIPLM opened 3 years ago

APIPLM commented 3 years ago

Went through the readme is such a pleasure. Most like slime/slime is a remote debug tool integrating into Emacs for common lisp, and it is part of IDE tool set. and then by this inspired, Geiser was created for the same purpose (remote debug) for scheme language (different dialect schemes). And http://api.call-cc.org have powerful way to navigate the scheme document in the chicken community by search node name of the document. What would this project like to be?

OpenAPI sound like quite popular as well. that way they build the documents

What ever the way would be? The first thing would be done is that the index in these meta-data for these document ( R5RS, R6RS R7RS and SRFIs)

lassik commented 3 years ago

Thanks for the kind words and interest!

api.scheme.org is meant to be like api.call-cc.org, but

I'm not familiar with OpenAPI. It looks like it uses a hierarchy (tree) model. We've been planning to use GraphQL, which uses a graph model instead of a tree model. The graph model is more flexible, since the user can make any query they like.

lassik commented 3 years ago

Geiser and SLIME are different, in that they connect directly to a running Scheme implementation. api.scheme.org is a static store of information, it doesn't remote-control a Scheme REPL. However, making Geiser use api.scheme.org (once the API is online) could be very useful.

lassik commented 3 years ago

Here's a comparison of OpenAPI and GraphQL. OpenAPI is simpler, but GraphQL is more flexible.