Hello all,

Will has worked quite a lot on l3doc. One of the newer ideas to to
replace the old \StopEventually / \Finale idea with:

\begin{documentation}
...
\end{documentation}
\begin{implementation}
...
\end{implementation}

This is, I think, a good idea. However, I wonder if a second level of
control might be a good thing. At the moment, the first section contains
all of the documentation. However, if you consider some user package, it
would be helpful to have the user functions and internal stuff
documented separately.  I wondered about:


\begin{documentation}
  \begin{user-functions}
   ...
  \end{user-functions}
  \begin{internal-functions}
   ...
  \end{internal-functions}
\end{documentation}

or

\begin{documentation}
...
\end{documentation}
\begin{programmers-documentation}
...
\end{programmers-documentation}

or ...

What do other people think?
-- 
Joseph Wright