On 16/05/14 10:55, Ralf Hemmecke wrote:
So I see at least 3 different kinds of documentation.
Ralf,
You have said you are a fan of LP but what you describe here looks to me
like a more conventional view of documentation. Are you saying that LP
would only apply to your 'C) Maintainer documentation'?
I seems to me (a view I may have got from Tim, but don't blame him if
I've got it wrong) is that a user may go backwards and forwards between
different ways of working from using FriCAS as a calculator to
maintaining/writing scripts, SPAD and system code and there are lots of
graduations in-between.
Documentation needs to support this. So you may start using FriCAS as a
calculator but then need to know how a function works, so you drill down
and get more and more details of the algorithm and eventually, if you
keep going, you are looking at the code.
I'm not sure that what is in the existing 'literate content' is purely
what you would classify as 'C) Maintainer documentation' so I still
think all documentation should be in the same place so users don't have
to guess how it is classified or look in several places.
Martin
--
You received this message because you are subscribed to the Google Groups "FriCAS -
computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to fricas-devel+unsubscr...@googlegroups.com.
To post to this group, send email to fricas-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/fricas-devel.
For more options, visit https://groups.google.com/d/optout.
