docs/api/nilearn.rst

@@ -1,8 +1,6 @@
 Nilearn
 =======
 
-This package provides re-implementations of some of the functions in `nilearn`_.
-
 .. automodule:: junifer.external.nilearn
    :members:
    :imported-members:

docs/api/onthefly.rst

@@ -1,8 +1,6 @@
 On-the-fly
 ==========
 
-This package provides functions for quick transform operations on stored data.
-
 .. automodule:: junifer.onthefly
    :members:
    :imported-members:

docs/changes/newsfragments/115.doc

@@ -0,0 +1 @@
+Improve sub-package level docstrings to better reflect their purposes by `Synchon Mandal`_

junifer/api/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for api sub-package."""
+"""Public API and CLI components."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/api/queue_context/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for queue context sub-package."""
+"""Context adapters for queueing."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/configs/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for configs sub-package."""
+"""Custom components for specific platforms."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 # License: AGPL

junifer/configs/juseless/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for juseless sub-package."""
+"""Custom components for FZJ INM-7's beloved juseless."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 # License: AGPL

junifer/configs/juseless/datagrabbers/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for datagrabbers sub-package."""
+"""Custom DataGrabbers for FZJ INM-7's beloved juseless."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Leonard Sasse <l.sasse@fz-juelich.de>

junifer/data/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for data sub-package."""
+"""Parcellations, coordinates and masks."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/data/coordinates.py

@@ -1,4 +1,4 @@
-"""Provide functions for list of coordinates."""
+"""Functions for coordinates manipulation."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/data/masks.py

@@ -1,4 +1,4 @@
-"""Provide functions for masks."""
+"""Functions for mask manipulation."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/data/parcellations.py

@@ -1,4 +1,4 @@
-"""Provide functions for parcellation."""
+"""Functions for parcellation manipulation."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Vera Komeyer <v.komeyer@fz-juelich.de>

junifer/data/template_spaces.py

@@ -1,4 +1,4 @@
-"""Provide functions for template spaces."""
+"""Functions for template space manipulation."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/datagrabber/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for datagrabber sub-package."""
+"""DataGrabbers for datasets' data description."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Leonard Sasse <l.sasse@fz-juelich.de>

junifer/datareader/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for datareader sub-package."""
+"""DataReaders for datasets' data loading."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Leonard Sasse <l.sasse@fz-juelich.de>

junifer/external/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for external sub-package."""
+"""External tools adapted for junifer."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/external/nilearn/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for custom nilearn objects sub-package."""
+"""Custom objects adapted from nilearn."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/markers/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for markers sub-package."""
+"""Markers for feature extraction."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Leonard Sasse <l.sasse@fz-juelich.de>

junifer/onthefly/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for onthefly sub-package."""
+"""Utilities for on-the-fly analyses."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/pipeline/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for pipeline sub-package."""
+"""Pipeline components."""
 
 # Authors: Synchon Mandal <s.mandal@fz-juelich.de>
 # License: AGPL

junifer/preprocess/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for preprocess sub-package."""
+"""Preprocessors for preprocessing data before feature extraction."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Leonard Sasse <l.sasse@fz-juelich.de>

junifer/stats.py

@@ -1,4 +1,4 @@
-"""Provide functions for statistics."""
+"""Statistical functions and helpers."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/storage/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for storage sub-package."""
+"""Storages for storing extracted features."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/testing/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for testing sub-package."""
+"""Testing components."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/testing/datagrabbers.py

@@ -1,4 +1,4 @@
-"""Provide testing DataGrabbers."""
+"""Testing DataGrabbers."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>

junifer/utils/__init__.py

@@ -1,4 +1,4 @@
-"""Provide imports for utils sub-package."""
+"""General utilities and helpers."""
 
 # Authors: Federico Raimondo <f.raimondo@fz-juelich.de>
 #          Synchon Mandal <s.mandal@fz-juelich.de>