DOC add IterativeReweightedL1 to doc + few cosmetic backticks (#140)

Author: mathurinm

doc/api.rst

@@ -90,4 +90,5 @@ Experimental
    :toctree: generated/
 
    SqrtLasso
-   PDCD_WS
+   PDCD_WS
+   IterativeReweightedL1

skglm/estimators.py

@@ -163,15 +163,15 @@ class GeneralizedLinearEstimator(LinearModel):
     Parameters
     ----------
     datafit : instance of BaseDatafit, optional
-        Datafit. If None, `datafit` is initialized as a `Quadratic` datafit.
-        `datafit` is replaced by a JIT-compiled instance when calling fit.
+        Datafit. If None, `datafit` is initialized as a ``Quadratic`` datafit.
+        ``datafit`` is replaced by a JIT-compiled instance when calling fit.
 
     penalty : instance of BasePenalty, optional
-        Penalty. If None, `penalty` is initialized as a `L1` penalty.
-        `penalty` is replaced by a JIT-compiled instance when calling fit.
+        Penalty. If None, `penalty` is initialized as a ``L1`` penalty.
+        ``penalty`` is replaced by a JIT-compiled instance when calling fit.
 
     solver : instance of BaseSolver, optional
-        Solver. If None, `solver` is initialized as an `AndersonCD` solver.
+        Solver. If None, ``solver`` is initialized as an ``AndersonCD`` solver.
 
     Attributes
     ----------

skglm/experimental/reweighted.py

@@ -13,15 +13,16 @@ class IterativeReweightedL1(GeneralizedLinearEstimator):
 
     Parameters
     ----------
-    alpha : float, optional
-        Penalty strength.
-
     datafit : instance of BaseDatafit, optional
         Datafit. If None, ``datafit`` is initialized as a ``Quadratic`` datafit.
         ``datafit`` is replaced by a JIT-compiled instance when calling fit.
 
+    penalty : instance of BasePenalty, optional
+        Penalty. If None, `penalty` is initialized as a ``L0_5`` penalty.
+        `penalty` is replaced by a JIT-compiled instance when calling fit.
+
     solver : instance of BaseSolver, optional
-        Solver. If None, `solver` is initialized as an `AndersonCD` solver.
+        Solver. If None, ``solver`` is initialized as an ``AndersonCD`` solver.
 
     n_reweights : int, optional
         Number of reweighting performed (convex surrogates solved).