author | Oleksandr Gavenko <gavenkoa@gmail.com> |
Mon, 19 Oct 2015 17:04:52 +0300 | |
changeset 1769 | cadd23f8127f |
parent 1334 | 9bf0d5a1f0cf |
child 1905 | fba288d59662 |
permissions | -rw-r--r-- |
1334
9bf0d5a1f0cf
Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
920
diff
changeset
|
1 |
.. -*- coding: utf-8; -*- |
9bf0d5a1f0cf
Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
920
diff
changeset
|
2 |
.. include:: HEADER.rst |
918 | 3 |
|
4 |
==================== |
|
5 |
TODO like keywords |
|
6 |
==================== |
|
7 |
.. contents:: |
|
8 |
||
9 |
Existing resources. |
|
10 |
=================== |
|
11 |
||
12 |
http://www.python.org/dev/peps/pep-0350/ |
|
13 |
Codetags |
|
920
05c1d6ef107b
http://tracos.org/codetag/
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
919
diff
changeset
|
14 |
http://tracos.org/codetag/ |
05c1d6ef107b
http://tracos.org/codetag/
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
919
diff
changeset
|
15 |
This project aims to provide a Toolset and RFC-style Pep usage |
05c1d6ef107b
http://tracos.org/codetag/
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
919
diff
changeset
|
16 |
convention for Codetags. |
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
17 |
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
|
18 |
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
|
19 |
Programming Practices |
918 | 20 |
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
|
21 |
Fixme Comment |
918 | 22 |
|
23 |
FIXME |
|
24 |
===== |
|
25 |
||
26 |
For things which are definitely broken, but where you want to not worry about |
|
27 |
it for the moment. |
|
28 |
||
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
29 |
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
|
30 |
|
918 | 31 |
TODO |
32 |
==== |
|
33 |
||
34 |
For useful features, optimizations or refactorings that might be worth doing |
|
35 |
in the future. |
|
36 |
||
37 |
TODO used to justify not completing code at the time it is first written. |
|
38 |
||
39 |
XXX |
|
40 |
=== |
|
41 |
||
919
7270274e29a3
Add tips from Code Conventions for the Java TM Programming Language.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
918
diff
changeset
|
42 |
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
|
43 |
|
918 | 44 |
For things that require more thought and that are arguably broken. |
45 |
||
46 |
An XXX demands attention and is not intended to stay in the code long. We may |
|
47 |
later decide that no problem exists. Or we may need to document unexpected |
|
48 |
behavior. If code is broken, we do not expect it to stay that way. We mark the |
|
49 |
problem immediately so that it is not forgotten. |
|
50 |
||
51 |
BUG |
|
52 |
=== |
|
53 |
||
54 |
BUG [ID бага] – обозначает, что в коде есть известный баг, который ещё не исправлен. |
|
55 |
REVIEW |
|
56 |
BROKEN |
|
57 |
HACK |
|
58 |
||
59 |
TRICKY |
|
60 |
====== |
|
61 |
||
62 |
Говорит о том, что код является мудрёным и нужно хорошо подумать прежде чем |
|
63 |
что-то в нём менять. |
|
64 |
||
65 |
WARNING |
|
66 |
======= |
|
67 |