lidavidm commented on issue #173: URL: https://github.com/apache/arrow-cookbook/issues/173#issuecomment-1089185560
Thanks! I was mostly wondering if there's a standard integration for .NET and Sphinx. If not, we can write our own (we already do for C++ and Java), it's then mostly a question of what would be most convenient. For example: in C++, we create a normal C++ project with unit tests. The unit tests are annotated with function calls that record output between certain points in the code and dump them to a file. The Sphinx plugin then reads in the file and inserts the output into the documentation, along with the section of code (which is automatically determined by looking for the start/stop function calls). That might work well for .NET too. If .NET has a REPL, that may also work; then we can embed code in the Sphinx docs, and write a plugin to evaluate them with the REPL. Personally I don't like it as much since it makes it hard to edit longer examples; Python gets by because Python is relatively concise, but for Java this approach is rather unwieldy. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
