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