<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#ffffff">
Hello,<br>
if this can fasten the building that much, it'll be awesome for me!<br>
Some things that came to my mind while browsing : <br>
<br>
-on the first page (
<a class="moz-txt-link-freetext"
href="http://www.scilab.org/team/sylvestre.ledru/scidoc/index.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/index.html</a>
), put on
the left side the table of contents, such as the one you can see while
you are on a "chapter element" (<a
href="http://www.scilab.org/team/sylvestre.ledru/scidoc/section_46d43fa43588512dc7dc2c3d190b775b.html">this
one
for exemple</a>)<br>
<br>
-there might be a need for a "search" item<br>
<br>
Simon<br>
<br>
On 20/10/2010 09:54, Clément David wrote:
<blockquote cite="mid:1287561295.4839.21.camel@pinarellu.inria.fr"
type="cite">
<pre wrap="">Hello,
Thanks for these improvements, It will ease the documentation
improvement.
First the user comment should be managed with care to avoid
documentation vandalism. Just sending a formatted mail should be
sufficient.
Then, there is some rendering problems on:
* <a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/INTEGRAL_m.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/INTEGRAL_m.html</a>
passing the mouse over "Dialog box" or any text underline it !
* <a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/MATEIG.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/MATEIG.html</a>
Passing the mouse over the first line of the example underline it !
*
<a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/section_10261ac2c63340e6a753699961fb03f4.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/section_10261ac2c63340e6a753699961fb03f4.html</a>
The content height is smaller then the left menu one. This lead to a
mixed text footer (should be a CSS problem only).
</pre>
<blockquote type="cite">
<pre wrap="">Hello guys,
Calixte (on the technical side) and I (on the complain side) have been
working on a rebuild of the documentation system of Scilab.
First, Calixte decreased the build time from 30 minutes (even 60 on some
configurations) to about 25 seconds. Even if it is not really important
to the normal user, this will help us in improving the documentation (it
was very frustrating to have to wait some long).
We took the time to redesign the online guide.
Here is a draft:
<a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/index.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/index.html</a>
Some examples:
<a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/zeros.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/zeros.html</a>
<a class="moz-txt-link-freetext" href="http://www.scilab.org/team/sylvestre.ledru/scidoc/datatipRemove.html">http://www.scilab.org/team/sylvestre.ledru/scidoc/datatipRemove.html</a>
We would like your feedback on this.
Please note some elements:
* we will add a component to switch between the various localization
(lang) of the same page.
* we will the possibility for a user to comment
* we will probably add a link "report a bug" from a page to encourage
user to contribute by reporting bugs
* we will to make available various Scilab versions documentations.
The embedded Scilab document has been also improved in the same way
(with some minor differences due to interface):
* In the embedded page in Scilab, we will have a "path" element which
will display:
Scilab :: Graphics Library :: datatips :: datatipRemove with a link on
each elements .
Thanks,
Calixte & Sylvestre
PS: The inspiration of this development comes from the excellent PHP
documentation.
Example: <a class="moz-txt-link-freetext" href="http://fr2.php.net/str_replace">http://fr2.php.net/str_replace</a>
</pre>
</blockquote>
<pre wrap="">
</pre>
</blockquote>
<br>
<br>
</body>
</html>