[Nek5000-users] Feedback Documentation
nek5000-users at lists.mcs.anl.gov
nek5000-users at lists.mcs.anl.gov
Fri Sep 8 17:35:29 CDT 2017
Hi,
I guess connected to that suggestion is the question whether one wants
to have doxygen-type of source documentation. Personally, I would find
that quite useful, and perhaps the easiest way of having source and
documentation in sync.
Best regards,
philipp
On 2017-09-08 18:39, nek5000-users at lists.mcs.anl.gov wrote:
> Hi Stefan,
>
> One thing that I think a lot of users (specifically relatively new and unexperienced Nek5000 users) can benefit from is that if there was a 1 or 2 line comment at the beginning of each subroutine that describes what the subroutine does. I realize it might not be practical to go back and modify the existing routines, but it would be nice if future additions/modifications to the code required the contributor to do this.
>
> p.s. I am sometimes guilty of not doing this.. for example - in my most recent PR for multimesh.f. I will address this and include comments in the subroutines that I have modified in multimesh.f in my next PR.
>
> Cheers,
> Ketan
> _______________________________________________
> Nek5000-users mailing list
> Nek5000-users at lists.mcs.anl.gov
> https://lists.mcs.anl.gov/mailman/listinfo/nek5000-users
>
More information about the Nek5000-users
mailing list