[GitHub] spark pull request: [SPARK-15130][PySpark][ML][DOCS] pyspark expos...

[MLnick]

Github user MLnick commented on the pull request:

    https://github.com/apache/spark/pull/12914#issuecomment-217875812
  
    @holdenk I'd prefer for us to find a way to document the default value in 
the API docs without resorting to stripping it out with a regex.
    
    This works for example:
    ```
        #: alpha for implicit preference. Default: 10
        alpha = Param(Params._dummy(), "alpha", "alpha for implicit preference",
                      typeConverter=TypeConverters.toFloat)
    ```
    However I agree the result doesn't look ideal:
    <img width="587" alt="screen shot 2016-05-09 at 3 29 39 pm" 
src="https://cloud.githubusercontent.com/assets/1036807/15114579/e34fb858-15fa-11e6-810b-d77504006a4b.png";>
    
    But surely there must be a way to get it to look better using something 
like this approach?


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---

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