sm4rtm4art commented on issue #11388: URL: https://github.com/apache/datafusion/issues/11388#issuecomment-3997931187
Hey everyone, Just wanted to give a quick update to let you know that I am still actively working on this issue! The scope expanded a bit more than I initially expected, but I’ve learned a ton and am really dedicated to adding value to the project. I had a few personal and technical hurdles to overcome recently, but those are fully resolved now. I've put a lot of hours into researching and writing this, and I believe I've now covered almost all the methods the DataFrame API provides. Right now, I'm in the final stretch. I am currently polishing the text and refactoring the structure (specifically, breaking down a massive monolithic markdown file into smaller, logical pieces in a new directory structure). My goal is to make the final PR easy for you all to review and maintain in the future. Furthermore, I would like to give others the opportunity to learn about and use useful functions in the documentation. **I do have one minor technical question for the group:** Sphinx offers a great way to highlight specific lines in code blocks using emphasize-lines (see [Sphinx docs](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-option-code-block-emphasize-lines)). However, cargo test --doc doesn't seem to parse Sphinx's directives for testing, as it strictly expects standard markdown ```rust blocks. **This is not a blocker! Just a nice to have** Does anyone know a clean workaround for this? For now, I will stick to standard markdown code blocks so that the doctests pass which is prioritized, but I'd love to use line highlights if possible. Thanks again for your generous patience and for letting me tackle this. I'm looking forward to opening the PR soon! -- 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] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
