Github user mengxr commented on a diff in the pull request:

    https://github.com/apache/spark/pull/10598#discussion_r52677518
  
    --- Diff: python/pyspark/mllib/classification.py ---
    @@ -272,37 +275,42 @@ def train(cls, data, iterations=100, step=1.0, 
miniBatchFraction=1.0,
             """
             Train a logistic regression model on the given data.
     
    -        :param data:              The training data, an RDD of
    -                                  LabeledPoint.
    -        :param iterations:        The number of iterations
    -                                  (default: 100).
    -        :param step:              The step parameter used in SGD
    -                                  (default: 1.0).
    -        :param miniBatchFraction: Fraction of data to be used for each
    -                                  SGD iteration (default: 1.0).
    -        :param initialWeights:    The initial weights (default: None).
    -        :param regParam:          The regularizer parameter
    -                                  (default: 0.01).
    -        :param regType:           The type of regularizer used for
    -                                  training our model.
    -
    -                                  :Allowed values:
    -                                     - "l1" for using L1 regularization
    -                                     - "l2" for using L2 regularization
    -                                     - None for no regularization
    -
    -                                     (default: "l2")
    -
    -        :param intercept:         Boolean parameter which indicates the
    -                                  use or not of the augmented 
representation
    -                                  for training data (i.e. whether bias
    -                                  features are activated or not,
    -                                  default: False).
    -        :param validateData:      Boolean parameter which indicates if
    -                                  the algorithm should validate data
    -                                  before training. (default: True)
    -        :param convergenceTol:    A condition which decides iteration 
termination.
    -                                  (default: 0.001)
    +        :param data:
    +          The training data, an RDD of LabeledPoint.
    +        :param iterations:
    +          The number of iterations.
    +          (default: 100)
    +        :param step:
    +          The step parameter used in SGD.
    +          (default: 1.0)
    +        :param miniBatchFraction:
    +          Fraction of data to be used for each SGD iteration.
    +          (default: 1.0)
    +        :param initialWeights:
    +          The initial weights.
    +          (default: None)
    +        :param regParam:
    +          The regularizer parameter.
    +          (default: 0.01)
    +        :param regType:
    +          The type of regularizer used for training our model.
    +          :Allowed values:
    +            - "l1" for using L1 regularization
    +            - "l2" for using L2 regularization
    +            - None for no regularization
    +          (default: "l2")
    --- End diff --
    
    If we use `:Allowed values:`, it shows up as `:Allowed values:` in html, 
which is weird. We should change existing ones instead of repeating the 
mistakes, in a separate PR. I don't think the rendered html changes due to that 
additional blank line. It is just control by top margin of a list, which could 
be configured via CSS. This is how it looks in html for my proposal, which 
looks good to me:
    
    ![screen shot 2016-02-11 at 2 21 41 
pm](https://cloud.githubusercontent.com/assets/829644/12992699/cb339390-d0ca-11e5-980f-779b0b97c97a.png)
    
    Let's quickly fix this one and merge this PR.


---
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

Reply via email to