[Starlingx-discuss] FW: REMINDER about updating STX REST API DOCUMENTATION
Waines, Greg
Greg.Waines at windriver.com
Fri Mar 6 12:22:11 UTC 2020
I thought I would send out this “nag” email again because I believe some starlingx contributors have been forgetting to update STX REST API DOCUMENTATION ... not 100% sure, just a hunch.
It is the responsibility of the contributor who changes / updates / creates STX REST APIs to also update the STX REST API DOCUMENTATION.
The HOWTO info on updating the new REST API DOCS can be found here:
https://docs.starlingx.io/contributor/api_contribute_guide.html
thanks,
Greg.
From: Greg Waines <Greg.Waines at windriver.com>
Date: Thursday, January 10, 2019 at 3:19 PM
To: "starlingx-discuss at lists.starlingx.io" <starlingx-discuss at lists.starlingx.io>
Subject: [Starlingx-discuss] REMINDER about updating STX REST API DOCUMENTATION
ALL StarlingX-Contributors,
This email is probably about 5 months too late ... apologies.
ATTENTION back in ~ September 2018, the StarlingX Documentation Team converted all of our StarlingX REST API Documents from those ugly wadl and yaml files into .rst / restructuredText files; basically aligning with the way all the other services in OpenStack are documenting REST APIs. The new API DOCS (.rst files) are now located under the applicable repos (or sub-repos).
It is the responsibility of the contributor who changes / updates / creates STX REST APIs to also update the STX REST API DOCUMENTATION.
( ... again, apologies for telling you this 5 months late ... )
The HOWTO info on updating the new REST API DOCS can be found here:
https://docs.starlingx.io/contributor/api_contribute_guide.html
Greg.
p.s. If you do know that you've changed an STX API in the last 5 months and know that you have NOT done the corresponding STX API DOC change, then minimally you need to raise a StarlingX Launchpad Bug on the issue with the details of the missing changes.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20200306/18cfbf60/attachment.html>
More information about the Starlingx-discuss
mailing list