I've tried docbook, but I just can't seem to write it. I want to help in translating but I just don't have the time to learn DocBook and translate :(.<br><br>DocBook is good, but perhaps a Wiki together with it, would be nice. It could host use-cases, tips, tutorials, I don't know.<br>

<br>George<br><br><div class="gmail_quote">On Thu, Jun 24, 2010 at 4:49 PM, Olivier Courtin <span dir="ltr"><<a href="mailto:olivier.courtin@oslandia.com">olivier.courtin@oslandia.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">

<br>
On Jun 24, 2010, at 9:05 PM, Pierre Racine wrote:<br>
<br>
Hi,<div class="im"><br>
<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
I know I will ennoy some people here but it seems to me that we would gain a lot by making the PostGIS documentation wiki style. We could benifit more from the community experience and be able to update it more quickly and frequently. What are the pros of keeping the documentation process that closed in the source tree in obscure XML comparing with open wiki pages?<br>


</blockquote>
<br></div>
Docbook is an abstract format<br>
So you could convert it (quite) easily to something else<br>
like XHTML or PDF or (quite) anything else you want.<br>
<br>
I'm not sure that a wiki is able to do thing like that<br>
<br>
And Wiki are not open,<br>
i mean that it's not an open standard<br>
there's a plenty of wiki syntax...<br>
<br>
Wiki is just simpler,<br>
And if you want a simpler way,<br>
you could copy/paste other part of the doc to get the grammar<br>
put your documentation stuff<br>
and use 'make check' rule to be sure that your doc is clean<div class="im"><br>
<br>
<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
Seems to me that since the appearance of wikis, fixed, closed documentations are very much old fashion and look like death things. Right now I think only one person is maintaining the doc. We could be more if it would be easier.<br>


</blockquote>
<br></div>
Regina and Kevin done an huge work to rewrite<br>
the doc and to maintain it since 1.4<br>
And i like the idea to have an official doc.<br>
<br>
But i'm agree with you,<br>
maybe there's a lack for user comments feature<br>
like in PostgreSQL doc for instance,<br>
<a href="http://www.postgresql.org/docs/8.4/interactive/index.html" target="_blank">http://www.postgresql.org/docs/8.4/interactive/index.html</a><div class="im"><br>
<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<br>
I know one of the argument is that each release need its own documentation since updates apply only to certain releases but to me this is not incompatible with a wiki. We can have one versions of the doc per release still in wiki style.<br>


</blockquote>
<br>
<br></div>
My 2 cents,<br>
<br>
--<br><font color="#888888">
Olivier</font><div><div></div><div class="h5"><br>
_______________________________________________<br>
postgis-devel mailing list<br>
<a href="mailto:postgis-devel@postgis.refractions.net" target="_blank">postgis-devel@postgis.refractions.net</a><br>
<a href="http://postgis.refractions.net/mailman/listinfo/postgis-devel" target="_blank">http://postgis.refractions.net/mailman/listinfo/postgis-devel</a><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br>George R. C. Silva<br><br>Desenvolvimento em GIS<br><a href="http://blog.geoprocessamento.net">http://blog.geoprocessamento.net</a><br>