Github user HyukjinKwon commented on the issue:

    https://github.com/apache/spark/pull/19485
  
    @gatorsmile, sure, detailed doc is great and defintely I support it.
    
    Just one thing I am worried of is duplication. If we add or change option, 
we have to update those  together and .. you know it.
    
    Wouldn't it be nicer if we simply leave a pointer and remove the 
duplication if possible? If I understood correctly, the options would also be 
described in more details in the future in the new chapter and I think simpliy 
redirecting it might be feasible.
    
    I guess it shouldn't be too difficult to make a sub-chapter for options 
only, for example, like 
http://spark.apache.org/docs/latest/sql-programming-guide.html#other-configuration-options
    
    Otherwise, would you maybe thimk there should be dfferent contents for a 
different purpose, or want to leave the duplication just for now as something 
to be fixed soon? If so, I am okay.


---

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

Reply via email to