updating documantation to reflect new default format percent ploomber…

…#564

doc/api/spec.rst

@@ -635,10 +635,10 @@ Python/R scripts/notebooks receive a ``product`` variable in the
 .. code-block:: py
     :class: text-editor
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     product = None
 
-    # + tags=["injected-parameters"]
+    # %% tags=["injected-parameters"]
     product = '/path/to/output/data.csv'
 
     # your code...
@@ -696,10 +696,10 @@ Python/R scripts/notebooks receive them in the "injected-parameters" cell:
 .. code-block:: py
     :class: text-editor
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     my_param = None
 
-    # + tags=["injected-parameters"]
+    # %% tags=["injected-parameters"]
     my_param = 42
 
     # your code...
@@ -1064,4 +1064,4 @@ to override this behavior:
             # scripts/my-script.py in Jupyter
             input_path: '{{here}}/some/path/file.json'
 
-For more on parametrized pipelines, check out the guide: :doc:`../user-guide/parametrized`.
+For more on parametrized pipelines, check out the guide: :doc:`../user-guide/parametrized`.

doc/get-started/basic-concepts.rst

@@ -110,14 +110,14 @@ as ``.py`` (script) and as a ``.ipynb`` (notebook) file:
    :target: /_static/img/basics/py-and-ipynb.png
    :alt: py-and-ipynb
 
-Note that the ``.py`` script has some ``# +`` comments. Such markers allow us
+Note that the ``.py`` script has some ``# %%`` comments. Such markers allow us
 to delimit code cells and render the ``.py`` file as a notebook. 
 
 .. note::
 
-   The ``# +`` is just one way of representing ``.py`` as notebooks. Ploomber
-   uses jupytext to perform the conversion, so other popular formats such as the
-   "percent" (``# %%``) format work. Editors such as VS Code, Spyder, and
+   The ``# %%`` is one way of representing ``.py`` as notebooks. Ploomber
+   uses jupytext to perform the conversion, other formats such as the
+   "light" (``# +``) format work too. Editors such as VS Code, Spyder, and
    PyCharm support the "percent" format.
 
 
@@ -146,10 +146,9 @@ editing. If a script/notebook has no dependencies, set ``upstream = None``.
     :class: text-editor
     :name: clean-py
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     upstream = ['raw'] # this means: execute raw.py, then clean.py
     product = None
-    # -
 
 
 .. important::
@@ -160,7 +159,7 @@ editing. If a script/notebook has no dependencies, set ``upstream = None``.
 
 .. note::
 
-   the ``# +`` and ``# -`` markers only apply to scripts.
+   the ``# %%`` markers only apply to scripts.
    `Click here <https://docs.ploomber.io/en/latest/user-guide/faq_index.html#parameterizing-notebooks>`_
    for information on adding tags to ``.ipynb`` files.
 
@@ -175,14 +174,15 @@ Let's review the contents a sample ``clean.py`` file:
 
    import pandas as pd
 
-   # + tags=["parameters"]
+   # %% tags=["parameters"]
    upstream = ["raw"]
    product = None
-   # -
 
+   # %%
    df = pd.read_csv(upstream['get']['data'])
    # some data cleaning code...
 
+   # %%
    # store clean data
    df.to_csv(str(product['data']), index=False)
 

doc/user-guide/faq/parameterize.rst

@@ -11,28 +11,27 @@ the ``upstream`` parameter, which contains a list of task dependencies.
 Parameterizing ``.py`` files
 *****************************
 
-For ``.py`` files, include the ``# + tags=["parameters]`` comment before declaring your default variables or parameters.
-The ``# +`` marker denotes the beginning of a cell, and ``# -`` marker indicates the end of the cell. Your cell should look like this:
+For ``.py`` files, include the ``# %% tags=["parameters]`` comment before declaring your default variables or parameters.
 
 
 .. code-block:: python
     :class: text-editor
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     upstream = None
     product = None
-    # -
-
 
-Note that Ploomber is compatible with all ``.py`` formats supported by jupytext. Another common alternative is the percent format:
+Note that Ploomber is compatible with all ``.py`` formats supported by jupytext. Another common alternative is the light format.
+The ``# +`` marker denotes the beginning of a cell, and ``# -`` marker indicates the end of the cell. Your cell should look like this:
 
 
 .. code-block:: python
     :class: text-editor
 
-    # %% tags=["parameters"]
+    # + tags=["parameters"]
     upstream = None
     product = None
+    # -
 
 If you're using another format, check out `jupytext's documentation <https://jupytext.readthedocs.io/en/latest/formats.html>`_.
 

doc/user-guide/r-support.rst

@@ -23,9 +23,9 @@ If you prefer, you can also use plain R scripts:
     :class: text-editor
     :name: task-R
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     upstream = list('one_task', 'another_task')
-    # -
+    #   
 
 
 If your script doesn't have dependencies: ``upstream = NULL``
@@ -98,4 +98,4 @@ but takes about a minute to be ready):
 .. image:: https://img.shields.io/badge/launch-session-579ACA.svg?logo=data:image/png;base64,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
    :target: https://mybinder.org/v2/gh/ploomber/binder-env/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252Fploomber%252Fprojects%26urlpath%3Dlab%252Ftree%252Fprojects%252Ftemplates/spec-api-r%252FREADME.ipynb%26branch%3Dmaster
 
-`Example source code <https://github.com/ploomber/projects/tree/master/templates/spec-api-r>`_
+`Example source code <https://github.com/ploomber/projects/tree/master/templates/spec-api-r>`_

doc/user-guide/spec-vs-python.rst

@@ -60,10 +60,10 @@ scripts support this, for example:
     :class: text-editor
     :name: task-py
 
-    # + tags=["parameters"]
+    # %% tags=["parameters"]
     product = {'nb': 'output.ipynb', 'data': 'output.csv'}
     upstream = ['a_task']
-    # -
+    # 
 
     # continues...