Project

General

Profile

Actions

Idea #21299

open

API reference documentation includes Python examples

Added by Brett Smith 5 months ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
Documentation
Target version:
Start date:
Due date:
Story points:
-

Description

Background: Most of our users using the Arvados API are doing so through the Python SDK. Showing examples in Python makes the reference documentation more useful to developers who may not have used web APIs before.

At the same time, the Python SDK isn't the only SDK, and we do want the reference documentation to be useful to developers using other SDKs, or even writing their own SDK.

Extend the API reference documentation so there's two version of each example: a Python version and a "plain HTTP" version. Each example offers the reader a way to switch between versions. That choice is remembered and used across all examples.

The system should have room to accommodate other versions in the future but those versions aren't added in this ticket, those are follow-up tickets.

No data to display

Actions

Also available in: Atom PDF