- changed title to Code formatting and checking & code documentation.
Code formatting and checking & code documentation.
I think it could be worth thinking about setting up a code formatting and checking system. There are a couple of Eclipse plugins, CheckStyle and PMD, that help doing so. CheckStyle (http://checkstyle.sourceforge.net/), as its name stands, checks the code style. It also allows to export an XML file with the desired settings, so all the people involved in a project could use the same settings. On the other hand, PMD (http://pmd.sourceforge.net/) is a source code analyzer that seeks a number of potential problems.
A less feasible proposal is to use Intent (http://www.eclipse.org/projects/project-plan.php?planurl=/intent/pages/plan/plan.xml) to implement a better documentation in OpenMarkov. Also, I need to say I have not been able to look to it thoroughly, so this part of the proposal needs a further and deeper look. But I think it was worth mentioning.
Comments (7)
-
reporter -
-
assigned issue to
- marked as major
Íñigo, Manolo, I think you are using those plug-ins and/or the XML file. Can you please have a look at it? It is not urgent, but the soon everybody starts using it, the better.
-
assigned issue to
-
Fine, Javier, I think it is a good idea. We are going to do this.
-
I think we should prepare basically three things related to this issue: 1. An XML formatter (or similar) for the code. (Miguel is giving ideas and Íñigo and Javier Vélez also had ideas with an XML file). 2. A set of coding and documentation rules. (Manuel Arias has a manual that could be the beginning...) 3. Some settings (I don't know if this can be stored in the file) for configuring the "Errors/Warnings" tab in Eclipse. For example, I think it is useful to change the option "Value of parameter is not used" from "Ignore" to "Warning".
-
reporter - marked as minor
-
-
assigned issue to
-
assigned issue to
-
- changed status to resolved
We are using the eclipse code formatter. You can use this formatter also in other IDE (using the xml format file or a plugin)
- Log in to comment