[GitHub] [spark] asaf400 commented on issue #24547: [MINOR][DOCS] Fix invalid documentation for StreamingQueryManager Class

[GitBox <gi...@apache.org>]

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:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org