conditional content

Author: hamelsmu

README.md

@@ -3,13 +3,12 @@ Getting started
 
 <!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
 
-**NB: This is nbdev v2, a new from-scratch rewrite of nbdev that’s not
-backwards compatible. Whilst the differences to nbdev1 aren’t huge, it
-does require some changes. So if you wish to continue to use nbdev1
-until you’ve got the time to upgrade, you can find the old version docs
-at [nbdev1.fast.ai](https://nbdev1.fast.ai). You can use version-pinning
-in your `requirements.txt` or `settings.ini` (i.e use `'nbdev<2'` as
-your dependency) to stop nbdev from being upgraded.**
+*NB: This is nbdev v2, a major upgrade of nbdev. Whilst the differences
+to nbdev1 aren’t huge, it does require some changes. The old version
+docs are at [nbdev1.fast.ai](https://nbdev1.fast.ai). You can use
+version-pinning in `settings.ini` (i.e `'nbdev<2'`) to stop nbdev from
+upgrading. To upgrade, follow the [migration
+tutorial](/migrating.html).*
 
 ------------------------------------------------------------------------
 
@@ -68,8 +67,15 @@ The best way to learn to use nbdev is to complete one of these tutorials
 square in the bottom right of the video; to view in a separate Youtube
 window, click the Youtube logo):
 
-<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/l7zS8Ld4_iA" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen>
-</iframe>
+<div>
+
+<div>
+
+[![](images/walkthrough.png)](http://www.youtube.com/watch?v=l7zS8Ld4_iA "nbdev walkthrough")
+
+</div>
+
+</div>
 
 (There’s an [alternate version of the
 walkthru](https://youtu.be/67FdzLSt4aA) avaialable with the coding
@@ -109,8 +115,6 @@ available commands:
     nbdev_trust                     Trust notebooks matching `fname`
     nbdev_update                    Propagate change in modules matching `fname` to notebooks that created them
 
-## FAQ
-
 ### Q: Someone told me not to use notebooks for “serious” software development!
 
 [Watch this video](https://youtu.be/9Q6sLbz37gk). Don’t worry, we still
@@ -121,20 +125,6 @@ clients](https://github.com/fastai/ghapi), [Python language
 extensions](https://github.com/fastai/fastcore), [terminal user
 interfaces](https://github.com/nat/ghtop), and more!
 
-## nbdev in the wild
-
-### fastai ecosystem
-
-`nbdev` has been used to build innovative software in the fastai
-ecosystem, including the [`fastai`](https://docs.fast.ai/) deep learning
-library which implements a [unique layered API and callback
-system](https://arxiv.org/abs/2002.04688), and
-[`fastcore`](https://fastcore.fast.ai/), which supercharges Python
-leveraging its dynamic nature. Furthermore, `nbdev` allows a very small
-number of developers to maintain and grow a [large
-ecosystem](https://github.com/fastai) of software engineering, data
-science, machine learning, and devops tools.
-
 ## Contributing
 
 If you want to contribute to `nbdev`, be sure to review the

nbs/getting_started.ipynb

@@ -79,7 +79,22 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube-nocookie.com/embed/l7zS8Ld4_iA\" frameborder=\"0\" allow=\"accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>"
+    "::: {.content-visible when-format=\"html\"}\n",
+    "\n",
+    "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube-nocookie.com/embed/l7zS8Ld4_iA\" frameborder=\"0\" allow=\"accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>\n",
+    "\n",
+    ":::"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "::: {.content-visible when-format=\"markdown\"}\n",
+    "\n",
+    "[![](images/walkthrough.png)](http://www.youtube.com/watch?v=l7zS8Ld4_iA \"nbdev walkthrough\")\n",
+    "\n",
+    ":::"
    ]
   },
   {
@@ -182,6 +197,18 @@
    "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.9.7"
   }
  },
  "nbformat": 4,