<br>Hi Asamwm,<br><br><br> This is an excellent idea !<br><br><br>and as you already pointed out,<br>it is fully consistent with the spirit of Open Source.<br><br><br> We can think about it as a <br><br> "Wikipedia for ITK".<br>
<br><br>The natural name that comes to mind is the<br><br> "InsightClopedia"<br><br><br>So far we have used the ITK Wiki mostly for <br>coordination among developers and users, <br>but we have not used it for "community supported<br>
documentation"<br><br>The nice thing is that we can start <b>right now,</b><br>and all the infrastructure is already in place,<br>given that we can do this directly in the ITK Wiki.<br><br>Given that any user can get Wiki write access now,<br>
(just need to perform an automatic email verification),<br>anybody willing to participate simply needs to get her/his<br>Wiki account, and we can start creating pages for <br>individual classes.<br><br>Note that we will also need pages for "groups" of classes<br>
that work together. For example, in the Image Registration<br>framework.<br><br>I just created the top level page at<br><br> <a href="http://www.itk.org/Wiki/ITK_InsightClopedia">http://www.itk.org/Wiki/ITK_InsightClopedia</a><br>
<br>and throwed an initial set of categories, <br>(that we will certainly have to reorganize latter).<br><br><br>At some point we may want to come-up with predefined<br>Wiki-macros, such as the ones used by the Wikipedia for<br>
"countries", "atomic elements" and so on, in such a way<br>that we standardize the basic information about every <br>class.<br><br><br> Please take a look at the top page and let us know<br> what you think.<br>
<br><br> Thanks<br><br><br> Luis<br><br><br><br><br>-------------<br>PS. Note that we could still do a community-effort on the Software Guide<br> itself, given that its it all in LaTeX, and it is hosted in the same CVS<br>
repository as ITK. (it may be a good option to keep in mind....)<br><br><br><br><br>----------------------------------------------------------------------------------------------<br><div class="gmail_quote">On Wed, Jul 1, 2009 at 1:04 AM, asamwm <span dir="ltr"><<a href="mailto:asamwm@gmail.com">asamwm@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Hi Luis,<br>since this is all in the spirit of open source community,<br>part of whose growth is credited to people from the <br>
community, why not create agree on an architecture<br>for community-based documentation where everyone<br>
who participates in developing/evaluating/using a filter<br>can contribute to the wiki. The journal is a stepping<br>stone but the more detailed, elaborated documentation<br>would be the wiki.<br>There would be fixed sections such as:<br>
general purpose (what problem it attacks, image examples)<br>advantages / why this one ,<br>known disadvantages (why not),<br>how it works (optimization),<br>same category as in (list of other filters)<br>see also (broader area)<br>
code snippets<br>pitfalls<br><br><br>I know one concern is to be careful not to misinform,<br>but this is the beauty of open source. The community<br>will correct falsehoods with time. Besides, this does<br>not need to replace the itksoftwareguide since<br>
that one is specific to the basics.<br><br>Just my 2c.<br>I do not know how everyone feels about this.<br>Please share.<br>Regards.<br><br><div class="gmail_quote"><div><div></div><div class="h5">On Tue, Jun 30, 2009 at 3:06 PM, Luis Ibanez <span dir="ltr"><<a href="mailto:luis.ibanez@kitware.com" target="_blank">luis.ibanez@kitware.com</a>></span> wrote:<br>
</div></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div><div></div><div class="h5"><br>
<br>
Hi Oliver,<br>
<br>
<br>
<br>
1) Yes, the ITK Software Guide is overdue for an update.<br>
<br>
<br>
2) You can see a manifesto of new filters on the Wiki<br>
page of every release.<br>
<br>
For example:<br>
<br>
<a href="http://www.itk.org/Wiki/ITK_Release_3.14" target="_blank">http://www.itk.org/Wiki/ITK_Release_3.14</a><br>
<a href="http://www.itk.org/Wiki/ITK_Release_3.12" target="_blank">http://www.itk.org/Wiki/ITK_Release_3.12</a><br>
<a href="http://www.itk.org/Wiki/ITK_Release_3.10" target="_blank">http://www.itk.org/Wiki/ITK_Release_3.10</a><br>
....<br>
<br>
<br>
3) Yes, the ITK Software Guide will be updated,<br>
probably in the next year or two.<br>
<br>
<br>
4) Since 2006, All new classes in ITK must have been<br>
described in Insight Journal papers.<br>
<br>
If you need information about a New class,<br>
there must be a paper in the Insight Journal<br>
describing this class.<br>
<br>
<br>
For example, the Chan and Vese level set filters<br>
are described in<br>
<br>
<a href="http://www.midasjournal.org/browse/publication/322" target="_blank">http://www.midasjournal.org/browse/publication/322</a><br>
<br>
<br>
<br>
<br>
Regards,<br>
<br>
<br>
Luis<br>
<br>
<br>
----------------<br>
Oliver Gloger wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hello together,<br>
<br>
Is it true that the SoftwareGuide did not change since 2005? On the other hand I can see from the mailing-list that there exist new filters now (i.e. itkScalarChanAndVeseSparseLevelSetImageFilter or other filters, which are not mentioned in the ITKSoftwareGuide). Will the ITKSoftwareGuide be updated? Where can I be informed about how to use new adjoined classes and filters in the ITK?<br>
<br>
best regards <br>
Oliver!<br>
<br>
<br>
<br>
</blockquote></div></div><div class="im">
_____________________________________<br>
Powered by <a href="http://www.kitware.com" target="_blank">www.kitware.com</a><br>
<br>
Visit other Kitware open-source projects at<br>
<a href="http://www.kitware.com/opensource/opensource.html" target="_blank">http://www.kitware.com/opensource/opensource.html</a><br>
<br>
Please keep messages on-topic and check the ITK FAQ at: <a href="http://www.itk.org/Wiki/ITK_FAQ" target="_blank">http://www.itk.org/Wiki/ITK_FAQ</a><br>
<br>
Follow this link to subscribe/unsubscribe:<br>
<a href="http://www.itk.org/mailman/listinfo/insight-users" target="_blank">http://www.itk.org/mailman/listinfo/insight-users</a><br>
</div></blockquote></div><br>
</blockquote></div><br>