--- a/devel-ideal-proj.rst Sat Feb 10 01:28:53 2018 +0200
+++ b/devel-ideal-proj.rst Sat Feb 10 01:30:24 2018 +0200
@@ -22,58 +22,58 @@
Close source projects have proprietary nature because of:
- * interest to make money (another parties can not easily reproduce project to
- get monopoly on market)
- * low code quality (to stop stain company good name or to stop malicious
- attacks based on code analysis)
- * security consideration (to hide protocols and data format to make harder
- malicious attack)
- * business model (closed data formats allow vendor lock)
+* interest to make money (another parties can not easily reproduce project to
+ get monopoly on market)
+* low code quality (to stop stain company good name or to stop malicious
+ attacks based on code analysis)
+* security consideration (to hide protocols and data format to make harder
+ malicious attack)
+* business model (closed data formats allow vendor lock)
Disadvantages of closed source project (in many case):
- * you can not directly contact with developers (only through support)
- * low support quality (supported ugually don't have tech skills)
- * paid support (and you have no enough money)
- * can not access to product bug tracing system (you only can submit bug via
- crash report application or technical support; publishing internal bugs can
- damage product reputation)
+* you can not directly contact with developers (only through support)
+* low support quality (supported ugually don't have tech skills)
+* paid support (and you have no enough money)
+* can not access to product bug tracing system (you only can submit bug via
+ crash report application or technical support; publishing internal bugs can
+ damage product reputation)
Component of software project.
==============================
- * Sources.
- * Documentation.
- * Version control system (VCS).
- * Bug tracking system (BTS).
- * Project news/history/changelog.
+* Sources.
+* Documentation.
+* Version control system (VCS).
+* Bug tracking system (BTS).
+* Project news/history/changelog.
Project home page.
==================
Project home page must provide:
- * project name
- * short info about project goal
- * project license
- * current project status
- * links to binary release
- * links to source release, how to get latest source from VCS
- * links to online/printed docs
- * how report bug (BUGS)
- * where send patch
- * contact info
+* project name
+* short info about project goal
+* project license
+* current project status
+* links to binary release
+* links to source release, how to get latest source from VCS
+* links to online/printed docs
+* how report bug (BUGS)
+* where send patch
+* contact info
Additionally:
- * help welcome, requirement to join to project
- * mail/news list for users/developers, how to subscribe/unsubscribe, where
- find archive, how search for keyword in archive
- * project history (NEWS, ChangeLog)
- * project policy (HACKING)
- * how build project (README, INSTALL)
- * list of contributor with contact info (MAINTAINERS, AUTHORS)
- * who use project
+* help welcome, requirement to join to project
+* mail/news list for users/developers, how to subscribe/unsubscribe, where
+ find archive, how search for keyword in archive
+* project history (NEWS, ChangeLog)
+* project policy (HACKING)
+* how build project (README, INSTALL)
+* list of contributor with contact info (MAINTAINERS, AUTHORS)
+* who use project
Docs.
=====
@@ -83,12 +83,17 @@
VCS.
====
-TAGS: VCS, version control system, SCM, source code management, DVCS,
- distributed version control system.
+Acronyms:
+
+* VCS - version control system.
+* SCM - source code management,
+* DVCS - distributed version control system.
- * CVS
- * SVN
- * Mercurial (hg)
- * git
- * bazaar
+Popular VCS:
+* Git
+* CVS
+* SVN
+* Mercurial (hg)
+* bazaar
+