Skip to content

Better internal services documentation #24

Closed

Description

@inclinedadarsh

Currently there are three services, all of which have few pretty complex route. To make this project more accessible, we need to have better documentation about all the services.

Here's what we need at the least (for each service):

  • All the endpoints
  • Schema of all requests
  • Schema of all responses
  • Examples

I believe this can be done in two different ways. First would be putting all this information in README files. The second way could be that we do this in our official documentation.

Activity

  1. changed the title [-][doc] Better services documentation[/-] [+]Better internal services documentation[/+] on Aug 14, 2025
  2. supreme-gg-gg commented on Aug 31, 2025

    @supreme-gg-gg
    Contributor

    This seems to be done in most services now, including preprocessing, jobs/training-job, training, inference! They now include: endpoints docs, schema docs, schema example, and a technical description of what's going on. Currently these technical docs are in README.md in each directory. User docs will be separated in either another repo or docs see #54 for work in progress.

    I'll close this first it seems to be completed as I've been updating docs along the way

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsImprovements or additions to documentation

    Type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions