asaf400 commented on issue #24547: [MINOR][DOCS] Fix invalid documentation for StreamingQueryManager Class URL: https://github.com/apache/spark/pull/24547#issuecomment-490435833 @srowen for sure, There are more places in the spark docs that have not-working examples, that I have encountered, personally. I believe @HyukjinKwon is right, as I was searching for pyspark knowledge resources, databricks saved me many times, with a full working example, somewhat self-contained (enough to learn from the example and implement on my code without actually 'running' the example) I'm currently in the process of building a spark cluster for data science infrastructure and data lake, during learning spark and pyspark I have come across numerous documentation problems, where spark docs would say `do this`, but that didn't work, and google helped with results of `do this, like that` - full example or same spark example but with correct syntax, results were mainly from databricks, and other bloggers (medium, etc..) As a first time user starting out with spark, which looks like (and is) a mature program, the devil is in the documentation, meaning a not-working example leads to loss of confidence in the program.. This is just the first time I actually make a PR about something that I found was wrong in official docs, I'll try to be more alert, and post more PR's as I re-encounter invalid docs..
---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
