Changes between Version 5 and Version 6 of CommitGuides

Timestamp:

06/30/08 09:21:40 (16 years ago)

Author:

Peter Kovacs

Comment:

--

CommitGuides

@@ -9 +9 @@
  - At each point, changes should be "clean", i.e. to be self-contained, and not include any changesets that were false starts. 
    - If you are working on a more substantial new feature or improvement, you probably want to commit frequently in order to make it possible the revert the changes that turn to be a bad idea later. Feel free to do that, but before you share your changes with others, you should clean your repository by removing the unwanted commits and concatenating those actually belong together. Here is a nice description how to do that: http://www.selenic.com/mercurial/wiki/index.cgi/TipsAndTricks 
- - When you add a new algorithm or data structure 
+ - When you add a new algorithm or data structure:
    - Take the hassle to write a complete doxygen documentation as well.
    - Place the documentation into an appropriate doxygen module.
    - Also provide an exhaustive test case, whenever it makes sense. 
+ - When you port files from the SVN repository:
+   1. Run the '''{{{scripts/rename-graphs}}}''' script for all the files you would like to port.
+   2. Check the renamings (e.g. {{{source()}}} and {{{target()}}} should be manually renamed to {{{u()}}} and {{{v()}}} for undirected graphs).
+   3. Also port the related test files, if there are any.
+     - Run the rename script for the test files, too.
+     - Print something to the output only if it really seems necessary. Do not print a message saying ''all test passed'' at the end of the output. (See #25 for details.)
+   4. Add all necessary files to the repository.
+   5. Check the documentation comments in the source codes.
+     - Use {{{\tparam}}} commands for template parameter documentation. (See #29 for details.)
+     - Remove {{{\author}}} commands. (See #39 for details.)
+     - Check the usage of Lemon/LEMON. (See #103 for details.)
+   5. Make sure that '''{{{make check}}}''' and '''{{{make distcheck}}}''' passes without any compilation warning.
+   6. Run '''{{{make html}}}''' and check the generated documentation of the new tools.
+
 
 == Commit Metainfo ==