author | Oleksandr Gavenko <gavenkoa@gmail.com> |
Wed, 03 Aug 2011 14:48:16 +0300 | |
changeset 919 | 7270274e29a3 |
parent 918 | bab1d4bfd0c9 |
child 920 | 05c1d6ef107b |
permissions | -rwxr-xr-x |
918 | 1 |
.. -*- coding: utf-8 -*- |
2 |
||
3 |
==================== |
|
4 |
TODO like keywords |
|
5 |
==================== |
|
6 |
.. contents:: |
|
7 |
||
8 |
Existing resources. |
|
9 |
=================== |
|
10 |
||
11 |
http://www.python.org/dev/peps/pep-0350/ |
|
12 |
Codetags |
|
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
13 |
http://java.sun.com/docs/codeconv/html/CodeConventions.doc9.html#395 |
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
14 |
Code Conventions for the Java TM Programming Language. |
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
15 |
Programming Practices |
918 | 16 |
http://c2.com/cgi/wiki?FixmeComment |
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
17 |
Fixme Comment |
918 | 18 |
|
19 |
FIXME |
|
20 |
===== |
|
21 |
||
22 |
For things which are definitely broken, but where you want to not worry about |
|
23 |
it for the moment. |
|
24 |
||
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
25 |
Use FIXME to flag something that is bogus and broken. |
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
26 |
|
918 | 27 |
TODO |
28 |
==== |
|
29 |
||
30 |
For useful features, optimizations or refactorings that might be worth doing |
|
31 |
in the future. |
|
32 |
||
33 |
TODO used to justify not completing code at the time it is first written. |
|
34 |
||
35 |
XXX |
|
36 |
=== |
|
37 |
||
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
38 |
Use XXX in a comment to flag something that is bogus but works. |
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
39 |
|
918 | 40 |
For things that require more thought and that are arguably broken. |
41 |
||
42 |
An XXX demands attention and is not intended to stay in the code long. We may |
|
43 |
later decide that no problem exists. Or we may need to document unexpected |
|
44 |
behavior. If code is broken, we do not expect it to stay that way. We mark the |
|
45 |
problem immediately so that it is not forgotten. |
|
46 |
||
47 |
BUG |
|
48 |
=== |
|
49 |
||
50 |
BUG [ID бага] – обозначает, что в коде есть известный баг, который ещё не исправлен. |
|
51 |
REVIEW |
|
52 |
BROKEN |
|
53 |
HACK |
|
54 |
||
55 |
TRICKY |
|
56 |
====== |
|
57 |
||
58 |
Говорит о том, что код является мудрёным и нужно хорошо подумать прежде чем |
|
59 |
что-то в нём менять. |
|
60 |
||
61 |
WARNING |
|
62 |
======= |
|
63 |