Tutorials Per API Partner about api3-docs

[wkande]

The problem with this concept (regardless where it lives) is API provider upkeep. Once these tutorials are created will they get maintained, retired? In the "real world" this needs to be done in an environment with a TTL clause. If the API provider does not update their info on a regular basis then the tutorial will become inactive. This would require more than a static website or a bunch of GitHub repos.

[wkande]

This might be possible with an advanced component. The docs would now need and authentication method to protect each use case.

I have not heard any further conversations on the issue since Aug 10th and not sure who had came up with the idea. Keeping this issue alive for now hoping for other input.

[dcroote]

I think this is at least partially covered by the Web3 API catalog on api3.org. For instance, the page for API provider Interzoid links to Airnode instructions and parameters for calling various endpoints.

[37Rb]

I agree with @dcroote. Rather than doing this in our official docs it should be done in the API-provider-owned Airnode docs for each API, which are linked to with the "+ Airnode" link on the API pages on our site. I think the marketing team should provide these examples. We did something similar with Bitcoin Bankathon here. We can work with the account managers to get good examples into the API Airnode docs.

[wkande]

Then we have a good consensus. I am closing this issue related to the Docs supporting this idea. I