devel-scm.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Sat, 10 Feb 2018 01:49:07 +0200
changeset 2230 9e6ad6607a9e
parent 2228 837f1337c59b
permissions -rw-r--r--
Fixed formatting.
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; -*-
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     2
1011
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     3
==========================================
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     4
 Software configuration management (SCM).
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     5
==========================================
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
.. contents::
1905
fba288d59662 Include only local subsections into TOC. This prevent duplication of
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
     7
   :local:
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
1011
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
     9
About.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    10
======
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    11
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    12
Configuration management covers the processes used to control, coordinate, and
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    13
track: code, requirements, documentation, problems, change requests, designs,
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    14
tools/compilers/libraries/patches, changes made to them, and who makes the
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    15
changes. (See the 'Tools' section for web resources with listings of
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    16
configuration management tools.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 954
diff changeset
    17
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    18
Request/issue/bug tracker.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    19
==========================
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
Each artifact can contain several attributes as:
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    22
2228
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    23
* Status.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    24
* Type.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    25
* Component.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    26
* Version.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    27
* Milestone.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    28
* Severity.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    29
* Priority.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    30
* Resolution.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    31
* ID.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    32
* Date.
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    33
* Reposter, assigned, CC.
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    34
2228
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    35
http://trac.edgewall.org/wiki/TracTickets
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    36
  The Trac Ticket System
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    37
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    38
Status/State.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    39
-------------
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
Open/Reopened/Closed.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    42
941
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    43
Type.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    44
-----
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
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
    47
etc.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    48
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    49
Component.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    50
----------
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
Component is a project module or a subsystem distinct by different criteria.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    53
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    54
This can be - client/server, host/target, ui/doc/installer, etc.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    55
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    56
Version.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    57
--------
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
Version vs. build/release number.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    60
---------------------------------
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
Version is a tag for 
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    63
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    64
Milestone.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    65
----------
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
Milestone is a data when issue should be resolved.
9291a7ce6efb Software configuration management.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    68
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    69
Severity.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    70
---------
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
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
    73
data), or misspelling.
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    74
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    75
Possible values::
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    76
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    77
  blocker critical major minor trivial
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    78
1314
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    79
See:
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    80
2228
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    81
http://www.debian.org/Bugs/Developer#severities
837f1337c59b Removed indentation that compiled into <blockquote>.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1912
diff changeset
    82
  Severity levels in Debian project.
1314
b057128c56ff Severity levels in Debian project.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1302
diff changeset
    83
1012
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    84
Priority.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    85
---------
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
How important is to fix bug. What bugs are first to fix.
719b12ec01c8 Severity/priority.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1011
diff changeset
    88
1044
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    89
Possible values::
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    90
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    91
  highest high normal low lowest
793f6133d454 Possible values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1012
diff changeset
    92
954
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    93
Resolution.
887fa4aff71f Status. Resolution.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 941
diff changeset
    94
-----------
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
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
    97