tips: devel-ideal-proj.rst@f994292b3721 (annotated)

1334 9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	1	.. -- coding: utf-8; --
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	2	.. include:: HEADER.rst
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	3
1416 f994292b3721 Fix typo. Oleksandr Gavenko <gavenkoa@gmail.com> parents: 1334 diff changeset	4	=====================================
f994292b3721 Fix typo. Oleksandr Gavenko <gavenkoa@gmail.com> parents: 1334 diff changeset	5	Ideal software development project.
f994292b3721 Fix typo. Oleksandr Gavenko <gavenkoa@gmail.com> parents: 1334 diff changeset	6	=====================================
1334 9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	7	.. contents::
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	8
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	9	About ideal software development model.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	10	=======================================
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	11
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	12	This file mainly discuss about open source software project.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	13
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	14	Open source.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	15	============
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	16
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	17	Open source software project have freedom how develop project and which
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	18	development toolchains use.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	19
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	20	Close source.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	21	=============
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	22
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	23	Close source projects have proprietary nature because of:
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	24
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	25	* interest to make money (another parties can not easily reproduce project or
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	26	steal realisation ideas/code, allowing another party get same product and get
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	27	company money)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	28	* low code quality (to stop stain company good name or to stop malicious
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	29	attacks based on code analysis)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	30	* security consideration (to hide protocols and data format to make harder
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	31	malicious attack)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	32	* business model (closed data formats allow vendor lock)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	33
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	34	Disadvantage of closed source project (in many case):
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	35
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	36	* you can not directly contact with developers (only through support)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	37	* low support quality
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	38	* paid support (and you have no enough money)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	39	* can not access to product bug tracing system (you only can submit bug via
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	40	crash report application or technical support, publicly appear internal bug
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	41	tracing can damage product reputation
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	42
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	43	Component of software project.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	44	==============================
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	45
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	46	* Src (sources).
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	47	* Doc (documentation).
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	48	* VCS (version control system).
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	49	* BTS (bug tracking).
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	50	* News (project news/history/changelog).
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	51
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	52	Project home page.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	53	==================
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	54
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	55	Project home page must provide:
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	56
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	57	* project name
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	58	* short info about project goal
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	59	* project license
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	60	* current project status
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	61	* links to binary release
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	62	* links to source release, how to get latest source from VCS
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	63	* links to online/printed docs
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	64	* how report bug (BUGS)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	65	* where send patch
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	66	* contact info
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	67
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	68	Additionally:
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	69
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	70	* help welcome, requirement to join to project
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	71	* mail/news list for users/developers, how to subscribe/unsubscribe, where
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	72	find archive, how search for keyword in archive
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	73	* project history (NEWS, ChangeLog)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	74	* project policy (HACKING)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	75	* how build project (README, INSTALL)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	76	* list of contributor with contact info (MAINTAINERS, AUTHORS)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	77	* who use project
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	78
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	79	Docs.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	80	=====
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	81
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	82	TODO
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	83
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	84	VCS.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	85	====
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	86
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	87	TAGS: VCS, version control system, SCM, source code management, DVCS,
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	88	distributed version control system.
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	89
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	90	* CVS
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	91	* SVN
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	92	* Mercurial (hg)
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	93	* git
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	94	* bazaar
9bf0d5a1f0cf Include common header with quick links. Oleksandr Gavenko <gavenkoa@gmail.com> parents: diff changeset	95

author	Oleksandr Gavenko <gavenkoa@gmail.com>
	Fri, 09 Nov 2012 20:01:10 +0200
changeset 1416	f994292b3721
parent 1334	9bf0d5a1f0cf
child 1417	dbc31accad4a
permissions	-rw-r--r--