devel-ideal-proj.rst
changeset 670 ee6f31557087
parent 271 594c6470789d
child 736 9b962c4c86e3
equal deleted inserted replaced
669:216fb0a6ca77 670:ee6f31557087
       
     1 -*- mode: outline; coding: utf-8 -*-
       
     2 
       
     3                       Ideal software development model.
       
     4 
       
     5 
       
     6 * Open source.
       
     7 
       
     8 Open source development have much freedom select any development model.
       
     9 
       
    10 
       
    11 * Close source.
       
    12 
       
    13 Close source sortware development restrict in using models, technic or
       
    14 software resources; restrict their public appear because of its proprietary
       
    15 nature.
       
    16 
       
    17 In many case you can not directly contact with developers (only through
       
    18 support). You can not access to product bug tracing system (you only can
       
    19 submit bug via crash report application or technical support); publicly appear
       
    20 internal bug tracing can damage product reputation. Internal
       
    21 architecture/protocol description can drop leading product position (allowing
       
    22 another party get same product and get company money).
       
    23 
       
    24 * Component.
       
    25 
       
    26  * Docs.
       
    27  * VCS.
       
    28  * Bug track.
       
    29  * News.
       
    30 
       
    31 ** Docs.
       
    32 
       
    33 Documentation must provide:
       
    34 
       
    35 ** Home page.
       
    36 
       
    37 Home page must provide:
       
    38 
       
    39  * project name
       
    40  * short info about project goal
       
    41  * project licence (COPYING)
       
    42  * currect project status
       
    43  * links to binary release
       
    44  * links to source release, how to get latest source from VCS
       
    45  * links to online/printed docs
       
    46  * how report bug (BUGS)
       
    47  * where send patch
       
    48  * contact info
       
    49 
       
    50 Additionally:
       
    51 
       
    52  * help welcome, requirement to join to project
       
    53  * mail/news list for users/developers, how to subscribe/unsubscribe, where
       
    54    find archive, how search for keyword in archive
       
    55  * project history (NEWS, ChangeLog)
       
    56  * project policy (HACKING)
       
    57  * how build project (README, INSTALL)
       
    58  * list of contributor with contact info (MAINTAINERS, AUTHORS)
       
    59  * who use project
       
    60 
       
    61 ** VCS.
       
    62 
       
    63 TAGS: VCS, version control system, SCM, source code management, DVCS,
       
    64       distributed version control system.
       
    65 
       
    66  * CVS
       
    67  * SVN
       
    68  * Mercurial (hg)
       
    69  * git
       
    70  * bazaar
       
    71 
       
    72 *** CVS
       
    73 
       
    74 *** SVN
       
    75 
       
    76 *** Mercurial (hg)
       
    77 
       
    78 *** git
       
    79 
       
    80 *** bazaar
       
    81