devel-scm.rst
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--
Include only local subsections into TOC. This prevent duplication of TOC when build single page HTML document. Also this make unnecessary CSS hack to hide document title as top level section.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1334
9bf0d5a1f0cf Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1314
diff changeset
     1
.. -*- coding: utf-8; -*-
9bf0d5a1f0cf Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1314
diff changeset
     2
.. include:: HEADER.rst
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
1011
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     4
==========================================
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     5
 Software configuration management (SCM).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     6
==========================================
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     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:
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     9
1011
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    10
About.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    11
======
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    12
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    13
Configuration management covers the processes used to control, coordinate, and
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    14
track: code, requirements, documentation, problems, change requests, designs,
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    15
tools/compilers/libraries/patches, changes made to them, and who makes the
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    16
changes. (See the 'Tools' section for web resources with listings of
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    17
configuration management tools.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    18
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    19
Request/issue/bug tracker.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    20
==========================
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    21
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    22
Each artifact can contain several attributes as:
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    23
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    24
 * Status.
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    25
 * Type.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    26
 * Component.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    27
 * Version.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    28
 * Milestone.
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    29
 * Severity.
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    30
 * Priority.
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    31
 * Resolution.
1302
2013edbad67a Request/issue/bug tracker.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1044
diff changeset
    32
 * ID.
2013edbad67a Request/issue/bug tracker.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1044
diff changeset
    33
 * Date.
2013edbad67a Request/issue/bug tracker.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1044
diff changeset
    34
 * Reposter, assigned, CC.
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    35
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    36
  http://trac.edgewall.org/wiki/TracTickets
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    37
                The Trac Ticket System
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    38
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    39
Status/State.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    40
-------------
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    41
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    42
Open/Reopened/Closed.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    43
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    44
Type.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    45
-----
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    46
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    47
Type is a kind of artifact - bug/issue or enhancement or suggestion or wanted,
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    48
etc.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    49
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    50
Component.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    51
----------
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    52
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    53
Component is a project module or a subsystem distinct by different criteria.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    54
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    55
This can be - client/server, host/target, ui/doc/installer, etc.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    56
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    57
Version.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    58
--------
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    59
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    60
Version vs. build/release number.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    61
---------------------------------
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    62
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    63
Version is a tag for 
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    64
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    65
Milestone.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    66
----------
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    67
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    68
Milestone is a data when issue should be resolved.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    69
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    70
Severity.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    71
---------
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    72
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    73
How danger is bug or issue. For example it may be crash, corruption (of user
1044
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    74
data), or misspelling.
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    75
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    76
Possible values::
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    77
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    78
  blocker critical major minor trivial
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    79
1314
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    80
See:
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    81
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    82
  http://www.debian.org/Bugs/Developer#severities
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    83
                Severity levels in Debian project.
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    84
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    85
Priority.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    86
---------
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    87
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    88
How important is to fix bug. What bugs are first to fix.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    89
1044
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    90
Possible values::
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    91
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    92
  highest high normal low lowest
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    93
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    94
Resolution.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    95
-----------
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    96
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    97
Reason for why a ticket was closed. One of fixed, invalid, wontfix, duplicate.
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    98