Browse code

core: several updates to the README

Daniel-Constantin Mierla authored on 10/06/2015 12:48:00
Showing 1 changed files
... ...
@@ -11,7 +11,8 @@ Table of contents
11 11
   III. Getting started
12 12
   IV.  About the project
13 13
   V.   Obtaining Help
14
-  VI.  More Information
14
+  VI.  Contributions
15
+  VII. More Information
15 16
 
16 17
 
17 18
 I. About Kamailio
... ...
@@ -20,32 +21,35 @@ I. About Kamailio
20 20
 Kamailio is an industrial-strength, free server for realtime communication,
21 21
 based on the Session Initiation Protocol (SIP RFC3261). 
22 22
 
23
-It is engineered to power Realtime Communications such as IP telephony and presence 
24
-infrastructures up to large scale. With embedded support for WebSockets, HTTP,
25
-MSRP and XMLrpc as well as Json-rpc it's a modern server, up to date with current
26
-standards.
23
+It is engineered to power Realtime Communications such as IP telephony and
24
+presence infrastructures up to large scale. With embedded support for
25
+WebSockets/WebRTC, HTTP, XSRP and XMLrpc as well as Json-rpc it's a modern
26
+server, up to date with current standards on IPv4/IPv6 and TLS security.
27 27
 
28 28
 Kamailio keeps track of users, sets up multimedia sessions, relays instant 
29
-messages and creates space for new plug-in applications. Its proven interoperability 
30
-guarantees seamless integration with components from other vendors, eliminating the 
31
-risk of a single-vendor trap. Kamailio has successfully participated in various 
32
-interoperability tests in which it worked with the products 
33
-of other leading SIP vendors.
34
-
35
-The Kamailio software enables a flexible plug-in model for new applications: Third parties 
36
-can easily link their plug-ins with the server code and provide thereby advanced and
37
-customized services. With a modern RPC interface, 3rd party application can integrate
38
-and interact with services provided by Kamailio. By using the EVAPI interface or the
39
-embedded HTTP server restful applications can be built.
40
-
41
-Kamailio's performance and robustness allows it to serve millions of users and accommodate needs
42
-of very large operators. With a low-cost dual-CPU, the Kamailio server is able to power 
43
-IP telephony services in an area as large as the Bay Area during peak hours.
44
-
45
-The Kamailio server is extremely configurable to allow the creation of various routing and 
46
-admission policies as well as setting up new and customized services. Its configurability 
47
-allows it to serve many roles: network security barrier, presence server, application server, 
48
-IMS server or PSTN gateway guard (Session Border Controller) for example.
29
+messages and creates space for new plug-in applications. Its proven
30
+interoperability guarantees seamless integration with components from other
31
+vendors, eliminating the risk of a single-vendor trap. Kamailio has
32
+successfully participated in various interoperability tests in which it worked
33
+with the products of other leading SIP vendors.
34
+
35
+The Kamailio software enables a flexible plug-in model for new applications:
36
+third parties can easily link their plug-ins with the server code and provide
37
+thereby advanced and customized services. With a modern RPC interface, 3rd
38
+party application can integrate and interact with services provided by
39
+Kamailio. By using the EVAPI interface or the embedded HTTP server restful
40
+applications can be built.
41
+
42
+Kamailio's performance and robustness allows it to serve millions of users and
43
+accommodate needs of very large operators. With a low-cost dual-CPU, the
44
+Kamailio server is able to power IP telephony services in an area as large as
45
+the Bay Area during peak hours.
46
+
47
+The Kamailio server is extremely configurable to allow the creation of various
48
+routing and admission policies as well as setting up new and customized
49
+services. Its configurability  allows it to serve many roles: network security
50
+barrier, presence server, application server,  IMS server or PSTN gateway guard
51
+(Edge Proxy / Session Border Controller) for example.
49 52
 
50 53
 
51 54
 II. Feature List
... ...
@@ -60,7 +64,13 @@ our web site for a current list.
60 60
 III. Getting started
61 61
 ====================
62 62
 
63
-The INSTALL document will guide you through the installation.
63
+The documentation wiki is an important source of tutorials for installing
64
+and understanding how Kamailio works:
65
+
66
+  * http://www.kamailio.org/wiki/
67
+
68
+The INSTALL document provides more details and guidelines that will help with
69
+the installation.
64 70
 
65 71
 Kamailio is composed of a core and additional modules. For each module
66 72
 there is a README with documentation on how to configure and use the 
... ...
@@ -74,15 +84,16 @@ IV. About kamailio.org
74 74
 ========================
75 75
 
76 76
 The Kamailio project has roots in a line of projects starting with SIP Express
77
-Router, then OpenSER and now Kamailio. A merge project was started during the fall
78
-of 2008 by developers from the OpenSER project, recently renamed to Kamailio.org
79
-and SIP Express Router (SER) from iptel.org. 
77
+Router, then OpenSER and now Kamailio. A merge project was started during the
78
+fall of 2008 by developers from the OpenSER project, recently renamed to
79
+Kamailio.org and SIP Express Router (SER) from iptel.org. 
80 80
 
81 81
 Kamailio is the result of a merge of the code base and years of experience from
82
-both developer teams. In release 4.0, during the spring of 2013, the
83
-merger of the products was completed and a unified product was released.
82
+both developer teams. During the development of the release 4.0, autumn-winter
83
+of 201w, the merger of the products was completed and a unified product was
84
+released.
84 85
 
85
-See http://www.kamailio.org/ for the story of SER, OpenSER/Kamailio and kamailio.org.
86
+See http://www.kamailio.org/ for the story of SER, OpenSER and Kamailio.
86 87
 
87 88
 V. Obtaining Help
88 89
 =================
... ...
@@ -97,8 +108,27 @@ list is set up for mutual help by the community of Kamailio users and developers
97 97
 To participate in the mailing list, subscribe at the following web address: 
98 98
          http://lists.sip-router.org/mailman/listinfo/sr-users
99 99
 
100
-VI. More Information
101
-====================
100
+The IRC channel #kamailio on freenode.net is a place where to meet and discuss
101
+with other members of Kamailio community.
102
+
103
+VI. Contributions
104
+=================
105
+
106
+Kamailio is an open source project managed and developed by its community.
107
+Anyone is welcome to join the development efforts and contribute with code,
108
+documentation or other resources that could help the project.
109
+
110
+For code contributions, follow the suggestions provided at:
111
+
112
+  * http://www.kamailio.org/wiki/devel/git-commit-guidelines
113
+
114
+The recommended way to contribute code is via pull requests to Kamailio
115
+project on Github:
116
+
117
+  * https://github.com/kamailio
118
+
119
+VII. More Information
120
+=====================
102 121
 
103 122
 Most up-to-date information is always available at our website,
104 123
                  http://www.kamailio.org/