Do we want a section on package structure in "expressive code?"

[sneakers-the-rat]

Continuing a thought here: https://github.com/pyOpenSci/lessons/issues/44#issuecomment-2428020643

I like the lessons that are developing here a lot!

So in the section on expressive code there are a lot of good ideas about naming, and right near the end it seems like there is a really nice spot to do a super brief spot about expressiveness in package structure.

What i'm thinking is something like

• in the same way that you group related operations into a function, you can think of a python module as a grouping of related functions, and a package is a nested grouping of modules.
  • you can use the structure of your package to communicate meaning as well
  • (i.e. the temperature.conversion.f_to_k/fahrenheit_to_kelvin example)
• your package structure and names can help someone know how to use your package
  • _private variable names indicate when something is an implementation detail they shouldn't use
  • importing objects from modules into a namespace and using __all__ = [] is another way to signal which things are intended to be used, and a way for you to signal relative importance/commonness - eg. pandas imports all their user-facing functions to the top level so you can do stuff like pd.to_datetime instead of needing to do pandas.core.api.to_datetime or pandas.core.tools.datetimes.to_datetime.