Finesse docs

Author: danielballan

docs/source/tutorials/writing.md

@@ -1,12 +1,5 @@
 # Writing Data
 
-```{warning}
-
-This is a highly experimental feature, recently introduced and included for
-evaluation by early users. At this time we do not recommend using it for
-anything important.
-```
-
 In this tutorial we will start Tiled in a mode where the client can
 write (upload) data for later retrieving, search, or sharing.
 
@@ -48,19 +41,19 @@ where `...` will be whatever secret was printed at server startup above.
 
 ## Write data
 
-Write array and tabular data.
+Write array.
 
 ```python
-# Write simple Python list (which gets converted to numpy.array).
->>> client.write_array([1, 2, 3], metadata={"color": "red", "barcode": 10})
-<ArrayClient shape=(3,) chunks=((3,),) dtype=int64>
-
 # Write an array.
 >>> import numpy
 >>> client.write_array(numpy.array([4, 5, 6]), metadata={"color": "blue", "barcode": 11})
 <ArrayClient shape=(3,) chunks=((3,),) dtype=int64>
 
-# Create an array and grow it by one
+# Write a Python list (which gets converted to numpy array).
+>>> client.write_array([1, 2, 3], metadata={"color": "red", "barcode": 10})
+<ArrayClient shape=(3,) chunks=((3,),) dtype=int64>
+
+# Create an array and grow it by one.
 >>> new_array = client.write_array([1, 2, 3])
 >>> new_array
 <ArrayClient shape=(3,) chunks=((3,),) dtype=int64>
@@ -72,10 +65,14 @@ Write array and tabular data.
 <ArrayClient shape=(4,) chunks=((3, 1),) dtype=int64>
 >>> new_array.read()
 array([1, 2, 3, 4])
+```
+
+Write tabular data in a pandas DataFrame.
 
-# Write a table (DataFrame).
+```python
 >>> import pandas
->>> client.write_dataframe(pandas.DataFrame({"x": [1, 2, 3], "y": [4, 5, 6]}), metadata={"color": "green", "barcode": 12})
+>>> df = pandas.DataFrame({"x": [1, 2, 3], "y": [4, 5, 6]})
+>>> client.write_dataframe(df, metadata={"color": "green", "barcode": 12})
 <DataFrameClient ['x', 'y']>
 ```