On 05/20/2011 11:48 AM, Benjamin Root wrote:

> Some other ideas I have had is to include a link to the glossary page in
> the page header next to "docs", and maybe the FAQ, as well?  I also want
> to expand the glossary page, and comb through the docstrings to
> incorporate more ":term:" usage.  However, I probably want to hold off
> on those ideas for the master branch.

Ben,

There is a tradeoff involved in adding more directives like ":term:" 
(which I was not even aware of): they make the html more clickable but 
they clutter the plain text.  Even for html, having too many links can 
be distracting and reduce readability.  So, use with caution.  If it is 
easy to find the glossary, then I am not sure there is any net advantage 
in using "term" directives.

Eric

------------------------------------------------------------------------------
What Every C/C++ and Fortran developer Should Know!
Read this article and learn how Intel has extended the reach of its 
next-generation tools to help Windows* and Linux* C/C++ and Fortran 
developers boost performance applications - including clusters. 
http://p.sf.net/sfu/intel-dev2devmay
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to