From 5142e47e73fdaa3533fcb1dae6be6a50b4a71166 Mon Sep 17 00:00:00 2001 From: Michael Hanke Date: Fri, 6 Oct 2023 14:36:43 +0200 Subject: [PATCH 1/3] Fix acknowlewdgements to use nested itemizations Was a description list item --- docs/acknowledgements.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/acknowledgements.rst b/docs/acknowledgements.rst index e594980a5..df906c66f 100644 --- a/docs/acknowledgements.rst +++ b/docs/acknowledgements.rst @@ -8,9 +8,10 @@ The DataLad project received support through the following grants: * German federal state of Saxony-Anhalt and the European Regional Development Fund (ERDF), Project: Center for Behavioral Brain Sciences, Imaging Platform * ReproNim project (NIH 1P41EB019936-01A1). * Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under grant SFB 1451 (431549029, INF project) -* European Union’s Horizon 2020 research and innovation programme under grant agreements: - * Human Brain Project SGA3 (H2020-EU.3.1.5.3, grant no. 945539) - * VirtualBrainCloud (H2020-EU.3.1.5.3, grant no. 826421) +* European Union’s Horizon 2020 research and innovation programme under grant agreements + + * Human Brain Project SGA3 (H2020-EU.3.1.5.3, grant no. 945539) + * VirtualBrainCloud (H2020-EU.3.1.5.3, grant no. 826421) .. figure:: artwork/src/funding.svg From b177bf5a6b98db3d47378363554909f4e2f23087 Mon Sep 17 00:00:00 2001 From: Michael Hanke Date: Fri, 6 Oct 2023 14:50:41 +0200 Subject: [PATCH 2/3] Decomplexify markup of macos installation box No list with custom enumeration, just plain "one option after the other". Also update the Python version to not look stale. --- docs/intro/installation.rst | 50 ++++++++++++++++++------------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/intro/installation.rst b/docs/intro/installation.rst index 7d762e623..f20130ae9 100644 --- a/docs/intro/installation.rst +++ b/docs/intro/installation.rst @@ -247,44 +247,44 @@ Python's package manager `. .. code-block:: text The script chardetect is installed in - '/Users/MYUSERNAME/Library/Python/3.7/bin' which is not on PATH. + '/Users/MYUSERNAME/Library/Python/3.11/bin' which is not on PATH. Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location. To fix this, add these paths to the ``$PATH`` environment variable. - You can either do this for your own user (1), or for all users of the computer (2) - (requires using ``sudo`` and authenticating with your computer's password): + You can do this for your own user account by adding something like the following + to the *profile* file of your shell (exchange the user name accordingly): - (1) Add something like (exchange the user name accordingly) - - .. code-block:: bash + .. code-block:: bash - export PATH=$PATH:/Users/MYUSERNAME/Library/Python/3.7/bin + export PATH=$PATH:/Users/MYUSERNAME/Library/Python/3.11/bin - to the *profile* file of your shell. If you use a :term:`bash` shell, this may - be ``~/.bashrc`` or ``~/.bash_profile``, if you are using a :term:`zsh` shell, - it may be ``~/.zshrc`` or ``~/.zprofile``. Find out which shell you are using by - typing ``echo $SHELL`` into your terminal. + If you use a :term:`bash` shell, this may be ``~/.bashrc`` or + ``~/.bash_profile``, if you are using a :term:`zsh` shell, it may be + ``~/.zshrc`` or ``~/.zprofile``. Find out which shell you are using by + typing ``echo $SHELL`` into your terminal. - (2) Alternatively, configure it *system-wide*, i.e., for all users of your computer - by adding the the path ``/Users/MYUSERNAME/Library/Python/3.7/bin`` to the file - ``/etc/paths``, e.g., with the editor :term:`nano`: + Alternatively, you could configure it *system-wide*, i.e., for all users of + your computer by adding the path + ``/Users/MYUSERNAME/Library/Python/3.11/bin`` to the file ``/etc/paths``, + e.g., with the editor :term:`nano` (requires using ``sudo`` and authenticating + with your password): - .. code-block:: bash + .. code-block:: bash - sudo nano /etc/paths + sudo nano /etc/paths - The contents of this file could look like this afterwards (the last line was - added): + The contents of this file could look like this afterwards (the last line was + added): - .. code-block:: bash + .. code-block:: bash - /usr/local/bin - /usr/bin - /bin - /usr/sbin - /sbin - /Users/MYUSERNAME/Library/Python/3.7/bin + /usr/local/bin + /usr/bin + /bin + /usr/sbin + /sbin + /Users/MYUSERNAME/Library/Python/3.11/bin Linux: (Neuro)Debian, Ubuntu, and similar systems From a328ce4d7527d0e2bb5c32ba10120e60abe6032b Mon Sep 17 00:00:00 2001 From: Michael Hanke Date: Wed, 1 Nov 2023 10:43:40 +0100 Subject: [PATCH 3/3] Stop excessive colonization I think the heading works just as fine without the prefix. Shorter is better. --- docs/basics/101-141-push.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/basics/101-141-push.rst b/docs/basics/101-141-push.rst index 66ca6440c..977d41583 100644 --- a/docs/basics/101-141-push.rst +++ b/docs/basics/101-141-push.rst @@ -1,7 +1,7 @@ .. _push: -Overview: The datalad push command ----------------------------------- +The datalad push command +------------------------ Previous sections on publishing DataLad datasets have each shown you crucial aspects of the functions of dataset publishing with