This mail is an automated notification from the task tracker
of the project: Savane.
/**************************************************************************/
[task #175] Latest Modifications:
Changes by:
Mathieu Roy <[EMAIL PROTECTED]>
'Date:
sam 26.06.2004 � 11:49 (Europe/Paris)
What | Removed | Added
---------------------------------------------------------------------------
Should Start On | jeu 12.02.2004 � 01:00 | jeu 12.02.2004 � 00:00
Should be Finished on | dim 12.02.2006 � 01:00 | dim 12.02.2006 � 00:00
------------------ Additional Follow-up Comments ----------------------------
Hum, in fact I am not personally considering replacing INSTALL and INSTALL.verbose.
This documentation does its job and have been improved by different persons according
to their installation experience. Sure, it can still be improved but removing it or
moving it does not seems necessary right now.
The problem is the lack of general documentation: the documentation inside specific
directories is fine to explain how making something specific working. But there is no
overview, explaining concepts in general, that's the issue. Such documentation should
be split in two part: one for the savane administrators, the others for the users.
I like LaTeX and I'm not very confident with texinfo, however texinfo seems better to
create html documentation for software. Would you be ok with texinfo? Otherwise,
indeed, using LaTeX is not a problem.
/**************************************************************************/
[task #175] Full Item Snapshot:
URL: <http://gna.org/task/?func=detailitem&item_id=175>
Project: Savane
Submitted by: Mathieu Roy
On: ven 13.02.2004 � 19:15
Should Start On: jeu 12.02.2004 � 00:00
Should be Finished on: dim 12.02.2006 � 00:00
Category: Packaging
Priority: 1 - Later
Resolution: None
Assigned to: None
Percent Complete: 0%
Status: Open
Effort: 0.00
Planned Release:
Summary: real documentation
Original Submission: A real documentation from Savane, site admin oriented,
non-site-specific should be written.. probably from scratch. Maybe still in texinfo,
but I do not find that format so wonderfull...
Commentaires :
------------------
-------------------------------------------------------
Date: sam 26.06.2004 � 11:49 By: Mathieu Roy <yeupou>
Hum, in fact I am not personally considering replacing INSTALL and INSTALL.verbose.
This documentation does its job and have been improved by different persons according
to their installation experience. Sure, it can still be improved but removing it or
moving it does not seems necessary right now.
The problem is the lack of general documentation: the documentation inside specific
directories is fine to explain how making something specific working. But there is no
overview, explaining concepts in general, that's the issue. Such documentation should
be split in two part: one for the savane administrators, the others for the users.
I like LaTeX and I'm not very confident with texinfo, however texinfo seems better to
create html documentation for software. Would you be ok with texinfo? Otherwise,
indeed, using LaTeX is not a problem.
-------------------------------------------------------
Date: sam 26.06.2004 � 10:59 By: Matteo Settenvini <tchernobog>
Since it has to be written by scratch, and since I'm interested in it, how about
LaTeX, and then a simple Makefile to generate HTML, txt, PDF and whatever else?
We could move all the documentation to the /doc directory, and INSTALL should then
point to that dir, imo, while INSTALL.verbose would have to be rewritten...
I noticed that some of the (scarce) informations about installation are redundant.
For detailed info, follow this link:
<http://gna.org/task/?func=detailitem&item_id=175>
_______________________________________________
Message sent via/by Gna!
http://gna.org/
_______________________________________________
Savane-dev mailing list
[EMAIL PROTECTED]
https://mail.gna.org/listinfo/savane-dev
