devel-ideal-proj.rst
changeset 2228 837f1337c59b
parent 1912 8b81a8f0f692
--- 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
+