Automate execution of Python code in documentation and getting started guide
Description
Ensure our documentation never contains broken code
Environment
Activity
Resolved for lengthy time (at least six months), closing in bulk
The linked issue has more information and is a duplicate of this one, so resolving this one in favor of SYNPY-105.
I think this is a nice to have for the Python client docs, and not related to the Synapse docs.
In synapser, the vignettes contains documentation on how to use a Synapse feature. All codes in the vignettes can be built as a part of our CI process. Which will guarantee that the examples we give users are correct. (Unless we mark certain part of the code to not be executed.)
In Python, we currently do not execute the example code blocks in our documentation. It’s the engineer and code reviewer’s job to make sure that once a feature/ function changes, the Python documentation is updated. This adds a manual step into the engineer workflow and can be forgotten.
This ticket is to explore options on executing the example code block in the Python client documentation as part of the build. If achieve, will give the engineer and code reviewer feedback about a document example needs to be updated.
Given our docs migration plan, does this issue still apply?
I would like to look into any open Python library that already does this for us.