Skip to content

EspressoSystems/tide-disco

Folders and files

NameName
Last commit message
Last commit date
Sep 29, 2023
Jul 27, 2022
Jun 13, 2022
Nov 29, 2022
Aug 18, 2022
Dec 13, 2023
Aug 10, 2022
Sep 29, 2023
Dec 14, 2023
Dec 14, 2023
Nov 29, 2022
May 14, 2022
Dec 10, 2023
Nov 14, 2023
Aug 10, 2022

Repository files navigation

Tide Disco

Discoverability support for Tide

We say a system is discoverable if guesses and mistakes regarding usage are rewarded with relevant documentation and assistance at producing correct requests. To offer this capability in a practical way, it is helpful to specify the API in data files, rather than code, so that all relevant text can be edited in one concise readable specification.

Leverages TOML to specify

  • Routes with typed parameters
  • Route documentation
  • Route error messages
  • General documentation

Goals

  • Context-sensitive help
  • Spelling suggestions
  • Reference documentation assembled from route documentation
  • Forms and other user interfaces to aid in the construction of correct inputs
  • Localization
  • Novice and expert help
  • Flexible route parsing, e.g. named parameters rather than positional parameters
  • API fuzz testing automation based on parameter types

Future

WebSocket support Runtime control over logging