Change faq.md titles.
TBR=phoglund@webrtc.org
No-Try: True
Bug: None
Change-Id: I9d12ed705674826fd9ac0718e09fbb3302c996bd
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/168900
Reviewed-by: Mirko Bonadei <mbonadei@webrtc.org>
Commit-Queue: Mirko Bonadei <mbonadei@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#30572}
diff --git a/docs/faq.md b/docs/faq.md
index ae319ee..ed91438 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,4 +1,6 @@
-# What is WebRTC?
+# FAQ
+
+### What is WebRTC?
WebRTC is an open framework for the web that enables Real Time Communications
in the browser. It includes the fundamental building blocks for high-quality
@@ -12,7 +14,7 @@
protocol level at the IETF.
-# Why should I use WebRTC?
+### Why should I use WebRTC?
We think you'll want to build your next video-chat style application using
WebRTC. Here's why:
@@ -35,7 +37,7 @@
scenario (for example, but not limited to, SIP, XMPP/Jingle, et al.).
-# What is the Opus audio codec?
+### What is the Opus audio codec?
[Opus][opus-link] is a royalty-free audio codec defined by IETF
RFC 6176. It supports constant and variable bitrate encoding from 6 kbit/s to
@@ -45,7 +47,7 @@
[opus-link]: http://opus-codec.org/
-# What is the iSAC audio codec?
+### What is the iSAC audio codec?
iSAC is a robust, bandwidth-adaptive, wideband and super-wideband voice codec
developed by Global IP Solutions, and is used in many Voice over IP (VoIP) and
@@ -54,7 +56,7 @@
project.
-# What is the iLBC audio codec?
+### What is the iLBC audio codec?
iLBC is a free narrowband voice codec that was developed by Global IP
Solutions, and is used in many Voice over IP (VoIP) and streaming audio
@@ -63,19 +65,19 @@
included as part of the WebRTC project.
-# What is the VP8 video codec?
+### What is the VP8 video codec?
VP8 is a highly-efficient video compression technology developed by the WebM Project. It is the video codec included with WebRTC.
-# What is the VP9 video codec?
+### What is the VP9 video codec?
Similar to VP8, VP9 is also from the WebM Project. Its a next-generation open video codec. From Chrome 48 on desktop and Android, VP9 will be an optional video codec for video calls. More details in [Google Developers][vp9-link].
[vp9-link]: https://developers.google.com/web/updates/2016/01/vp9-webrtc/
-# What other components are included in the WebRTC package?
+### What other components are included in the WebRTC package?
-## Audio
+#### Audio
WebRTC offers a complete stack for voice communications. It includes not only
the necessary codecs, but other components necessary to great user
@@ -84,7 +86,7 @@
hardware access and control across multiple platforms.
-## Video
+#### Video
The WebRTC project builds on the VP8 codec, introduced in 2010 as part of the
[WebM Project][webm-link]. It includes components to conceal
@@ -93,7 +95,7 @@
[webm-link]: http://www.webmproject.org/
-## Network
+#### Network
Dynamic jitter buffers and error concealment techniques are included for audio
and video, which help mitigate the effects of packet loss and unreliable
@@ -101,21 +103,21 @@
connection using ICE / STUN / Turn / RTP-over-TCP and support for proxies.
-# How do I access the WebRTC code?
+### How do I access the WebRTC code?
-Go to [https://webrtc.googlesource.com/src][webrtc-repo-link]
+Go to [https://webrtc.googlesource.com/src][webrtc-repo-link].
[webrtc-repo-link]: https://webrtc.googlesource.com/src
-# How can I test the quality of WebRTC components?
+### How can I test the quality of WebRTC components?
We have put sample applications [here][examples-link].
[examples-link]: https://webrtc.googlesource.com/src/+/refs/heads/master/docs/native-code/development/index.md#example-applications
-# Are WebRTC components subject to change?
+### Are WebRTC components subject to change?
WebRTC is based on a API that is still under development through efforts at
WHATWG, W3C and IETF. We hope to get to a stable API once a few browser
@@ -126,7 +128,7 @@
feature set.
-# WebRTC components are open-source. How do I get the source and contribute code?
+### WebRTC components are open-source. How do I get the source and contribute code?
Please see [Getting Started][getting-started-link] and
[Contributing bug fixes][contributing-link] for more information.
@@ -135,7 +137,7 @@
[contributing-link]: https://webrtc.org/support/contributing
-# To be a Contributor, do I need to sign any agreements?
+### To be a Contributor, do I need to sign any agreements?
Yes, each Contributor must sign and return the
[Contributor License Agreement][cla-link]
@@ -143,7 +145,7 @@
[cla-link]: https://developers.google.com/open-source/cla/individual?hl=en
-# Do I have to be a programmer to use WebRTC?
+### Do I have to be a programmer to use WebRTC?
Yes, to build WebRTC support into a software application or contribute
improvements, programming skills are required. However, usage of the
@@ -151,26 +153,26 @@
development skills.
-# Is the WebRTC project owned by Google or is it independent?
+### Is the WebRTC project owned by Google or is it independent?
WebRTC is an open-source project supported by Google, Mozilla and Opera. The
API and underlying protocols are being developed jointly at the W3C and IETF.
-# Are the WebRTC components from Google's acquisition of Global IP Solutions?
+### Are the WebRTC components from Google's acquisition of Global IP Solutions?
Yes. Some components, such as VoiceEngine, VideoEngine, NetEQ, AEC, et al. all
stem from the GIPS acquisition.
-# What codecs are supported in WebRTC?
+### What codecs are supported in WebRTC?
The currently supported voice codecs are G.711, G.722, iLBC, and iSAC, and VP8
is the supported video codec. The list of supported codecs may change in the
future.
-# Please explain how WebRTC is free of charge?
+### Please explain how WebRTC is free of charge?
Some software frameworks, voice and video codecs require end-users,
distributors and manufacturers to pay patent royalties to use the intellectual
@@ -182,14 +184,14 @@
[license-link]: https://webrtc.googlesource.com/src/+/refs/heads/master/docs/license/index.md
-# What does this license let me do?
+### What does this license let me do?
Like most BSD licenses, this license allows you to use the WebRTC code with a
minimum of restrictions on your use. You can use the code in proprietary
software as well as open source software.
-# Do I need to release the source if I make changes?
+### Do I need to release the source if I make changes?
No, the license does not require you to release source if you make changes.
However, we would love to see any changes you make and possibly incorporate
@@ -199,7 +201,7 @@
[code-review-link]: https://webrtc-review.googlesource.com/
-# Why is there a separate patent grant?
+### Why is there a separate patent grant?
In order to decouple patents from copyright, thus preserving the pure BSD
nature of the copyright license, the license and the patent grant are
@@ -208,13 +210,13 @@
compatible with all major license scenarios.
-# What if someone gets the code from Google and gives it to me without changes. Do I have a patent grant from Google?
+### What if someone gets the code from Google and gives it to me without changes. Do I have a patent grant from Google?
Yes, you still have the right to redistribute and you still have a patent
license for Google's patents that cover the code that Google released.
-# What if someone makes a change to the code and gives it to me. Do I have a patent license from Google for that change?
+### What if someone makes a change to the code and gives it to me. Do I have a patent license from Google for that change?
You still have the right to redistribute but no patent license for the changes
(if there are any patents covering it). We can't give patent licenses for
@@ -223,13 +225,13 @@
including the Apache license.
-# What if Google receives or buys a patent that covers the code I receive sometime after I receive the code. Do I have a patent grant for that patent?
+### What if Google receives or buys a patent that covers the code I receive sometime after I receive the code. Do I have a patent grant for that patent?
Yes, you still have the right to redistribute and you still have a patent
license for Google's patents that cover the code that Google released.
-# What if my competitor uses the code and brings patent litigation against me for something unrelated to the code. Does he or she still have a patent license?
+### What if my competitor uses the code and brings patent litigation against me for something unrelated to the code. Does he or she still have a patent license?
Yes, he/she still has the right to redistribute and he/she still has a patent
license for Google's patents that cover the code that Google released.
