<div dir="ltr"><div>Yes, Utkash, I understand, though this seems like a short sighted strategy. Paraview is different from other successful open source projects by the lack of proper developers documentation. Kitware may be adding feature after feature, but I have some doubts whether this improves the software quality. The sources contain hundreds of comments such as "not sure why, but the old code was doing this...", "not sure about this one, hopefully it doesn't  affect..." etc. I get the impression that none of the developers gets the complexity of the package anymore, and bugs are only fixed by their symptoms, not by investigating the source of the trouble.</div><div>Maybe Kitware should advertise some funding campaign to document the ParaView design, its programming paradigms, its client-server architecture and Qt UI from a developers point of view etc. You'd win thousands of developers that are currently lost and seek futile help on the mailing lists. We'd invest many hundreds bucks in such a documentation campaign, and I expect thousands of other institutions, companies or individuals to join in.</div><div>We'll discuss whether we can still depend on a software that is mostly documented by its c++ sources. Probably we will, as there is no real alternative to Paraview :(</div><div><br></div><div>Many thanks,</div><div>Jussuf</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 29, 2018 at 11:22 PM, Utkarsh Ayachit <span dir="ltr"><<a href="mailto:utkarsh.ayachit@kitware.com" target="_blank">utkarsh.ayachit@kitware.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Jussuf,<br>
<br>
The debugger is your friend (and mine too). I'd suggest stepping through<br>
the code and things will start getting clear. While<br>
pqPropertyWidget::<wbr>addPropertyLink has no docs, if you  follow the<br>
code down to pqPropertyLinks::<wbr>addPropertyLink there's quite a bit of docs.<br>
Of course, community members are welcome to update docs, fill in the holes,<br>
make things clearer, etc.<br>
<br>
Thorough developer docs are ideal and we would love to, unfortunately, are<br>
not something that we can do, given limited resources. Given a choice<br>
between developing fixes/features paid for the supporters that fund ParaView<br>
development, adding user docs/posts that impact a broader community of<br>
users and adding<br>
developer docs, I am afraid the first two always win out. Contributions are<br>
always welcome, however.<br>
<span class="HOEnZb"><font color="#888888"><br>
Utkarsh<br>
</font></span></blockquote></div><br></div>