Copybara import of the project:

--
2e10911 by Avital Oliver <avitalo@google.com>:

Delete old examples/, rename linen_examples/ -> examples/

Keep the old LM1b example as examples/lm1b_deprecated, until #567
is resolved, per @levskaya's plan.

COPYBARA_INTEGRATE_REVIEW=#884 from avital:remove-examples-take-2 2e10911
PiperOrigin-RevId: 352540597

examples/README.md

@@ -1,6 +1,4 @@
-# Deprecated Examples
-
-You've caught us mid-way through our chrysalis! This directory
-contains examples with the deprecated `flax.nn` API.
-
-[linen_examples/](../linen_examples) now contains our supported examples.
+# Flax Examples
+
+ Please see documentation on RTD:
+ https://flax.readthedocs.io/en/latest/examples.html

linen_examples/cloud/README.md → examples/cloud/README.md

@@ -53,7 +53,7 @@ Use the following command to launch the MNIST example on cloud (make sure to set
 `$PROJECT` and `$GCS_BUCKET` accordingly):
 
 ```shell
-python linen_examples/cloud/launch_gce.py \
+python examples/cloud/launch_gce.py \
   --project=$PROJECT \
   --zone=us-central1-a \
   --machine_type=n2-standard-2 \
@@ -91,7 +91,7 @@ command (make sure to set `$PROJECT`, `$GCS_BUCKET` and `$GCS_TFDS_BUCKET`
 accordingly):
 
 ```shell
-python linen_examples/cloud/launch_gce.py \
+python examples/cloud/launch_gce.py \
   --project=$PROJECT \
   --zone=us-central1-a \
   --machine_type=n1-standard-96 \

linen_examples/cloud/startup_script.sh → examples/cloud/startup_script.sh

@@ -46,14 +46,14 @@ tmux send "
       pip install --upgrade jax jaxlib==0.1.57+cuda110 -f https://storage.googleapis.com/jax-releases/jax_releases.html
     fi &&
 
-    cd linen_examples/$EXAMPLE &&
+    cd examples/$EXAMPLE &&
     pip install -r requirements.txt &&
     cd $HOME
   ) &&
 
   cd flax &&
   . env/bin/activate &&
-  cd linen_examples/$EXAMPLE &&
+  cd examples/$EXAMPLE &&
 
   TFDS_DATA_DIR='$TFDS_DATA_DIR' python main.py --workdir=$WORKDIR $ARGS