> -- igor писал(а):
> ... чтобы обрести ясность что делает та или иная процедура, и как она используется в самом модуле. ... понять какие из них являются ключевыми, а какие служат лишь для того, чтобы обеспечить реализацию этих ключевых процедур....
Прежде всего, это значит, что формализм самого языка программирования такого соответствующего качества, если он не может обеспечить порядок. В некоторых языках воюют до последнего, оставляя даже для комментариев потенциал структурности, как окончательный рубеж фронта. Пример для Хаскеля (отсюда):
## Код:
```
-- | Little example
module Hello(
    -- * Introduction
    -- | Here is the little example to show you
    -- how to make docs with Haddock
    
    -- * Types
    -- | The types.
    T(..),
    -- * Classes
    -- | The classes.
    C(..),
    -- * Functions
    helloWorld
    -- ** Subfunctions1
    -- ** Subfunctions2    
) where

...
```

> -- Цитата:
> ...Комментарии со звёздочкой создают раздел, а с двумя звёздочками – подраздел. Те определения, которые экспортируются за комментариями со звёздочкой попадут в один раздел или подраздел. Если сразу за комментарием со звёздочкой идёт комментарий со знаком “или”, то он будет помещён в самое начало раздела. В нём мы можем пояснить по какому принципу группируются определения в данном разделе....