diff --git a/datasets/doc/source/how-to-use-with-tensorflow.rst b/datasets/doc/source/how-to-use-with-tensorflow.rst index a63145d9dffa..3dc8474b726a 100644 --- a/datasets/doc/source/how-to-use-with-tensorflow.rst +++ b/datasets/doc/source/how-to-use-with-tensorflow.rst @@ -25,7 +25,7 @@ In case of CIFAR10, you should see the following output. 'label': ClassLabel(names=['airplane', 'automobile', 'bird', 'cat', 'deer', 'dog', 'frog', 'horse', 'ship', 'truck'], id=None)} -We will use the keys in the partition features in order to construct a `tf.data.Dataset _`. Let's move to the transformations. +We will use the keys in the partition features in order to construct a `tf.data.Dataset `_. Let's move to the transformations. NumPy ----- diff --git a/doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst b/doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst index d9a4cf6b7c82..19d46c5753c6 100644 --- a/doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst +++ b/doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst @@ -14,7 +14,7 @@ Source: `Official VSCode documentation `_. +Configuring and setting up the :code:`Dockerfile` as well the configuration for the devcontainer can be a bit more involved. The good thing is you don't have to do it. Usually it should be enough to install `Docker `_ on your system and ensure its available on your command line. Additionally, install the `VSCode Containers Extension `_. Now you should be good to go. When starting VSCode, it will ask you to run in the container environment and - if you confirm - automatically build the container and use it. To manually instruct VSCode to use the devcontainer, you can, after installing the extension, click the green area in the bottom left corner of your VSCode window and select the option *(Re)Open Folder in Container*. diff --git a/doc/source/contributor-how-to-write-documentation.rst b/doc/source/contributor-how-to-write-documentation.rst index 232c37f06e1b..fcd8c5bb18c6 100644 --- a/doc/source/contributor-how-to-write-documentation.rst +++ b/doc/source/contributor-how-to-write-documentation.rst @@ -7,7 +7,7 @@ Project layout The Flower documentation lives in the ``doc`` directory. The Sphinx-based documentation system supports both reStructuredText (``.rst`` files) and Markdown (``.md`` files). -Note that, in order to build the documentation locally (with ``poetry run make html``, like described below), `Pandoc _` needs to be installed on the system. +Note that, in order to build the documentation locally (with ``poetry run make html``, like described below), `Pandoc `_ needs to be installed on the system. Edit an existing page diff --git a/doc/source/contributor-tutorial-get-started-as-a-contributor.rst b/doc/source/contributor-tutorial-get-started-as-a-contributor.rst index 3fdb52b5ddb1..e035d1b9867d 100644 --- a/doc/source/contributor-tutorial-get-started-as-a-contributor.rst +++ b/doc/source/contributor-tutorial-get-started-as-a-contributor.rst @@ -30,8 +30,8 @@ but you can change it by providing a specific :code:``):: $ ./dev/venv-create.sh -If you don't have :code:`pyenv` installed, -you can use the following script that will install pyenv, +If you don't have :code:`pyenv` installed, +you can use the following script that will install pyenv, set it up and create the virtual environment (with :code:`Python 3.8.17` by default):: $ ./dev/setup-defaults.sh @@ -83,7 +83,7 @@ Run Github Actions (CI) locally ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Developers could run the full set of Github Actions workflows under their local -environment by using `Act _`. Please refer to +environment by using `Act `_. Please refer to the installation instructions under the linked repository and run the next command under Flower main cloned repository folder:: @@ -116,6 +116,6 @@ convenience script to re-build the documentation yet, but it's pretty easy:: This will generate HTML documentation in ``doc/build/html``. -Note that, in order to build the documentation locally -(with ``poetry run make html``, like described below), -`Pandoc _` needs to be installed on the system. +Note that, in order to build the documentation locally +(with ``poetry run make html``, like described below), +`Pandoc `_ needs to be installed on the system.