summaryrefslogtreecommitdiffstats
path: root/pdk
diff options
context:
space:
mode:
authorSteve Block <steveblock@google.com>2010-09-02 14:29:43 +0100
committerSteve Block <steveblock@google.com>2010-09-02 14:45:16 +0100
commit9449ecee467ab8b5da4de85148e387399a02ea22 (patch)
tree4e8284e40a106bca61cb034e04cce73a2c69b040 /pdk
parent5f2cb81aec5a7b1cb1d8d11ed2474713ea8a2798 (diff)
downloadandroid_development-9449ecee467ab8b5da4de85148e387399a02ea22.tar.gz
android_development-9449ecee467ab8b5da4de85148e387399a02ea22.tar.bz2
android_development-9449ecee467ab8b5da4de85148e387399a02ea22.zip
Updates source.android.com for external contributions to WebKit
Instructs external contributors that changes to external/webkit should be made directly at webkit.org. I've assumed that in the future we will (or should now) direct external contributors to make changes upstream for other upstream projects too. Change-Id: I538930794907729ebcca4cbb20a2952d0159873f
Diffstat (limited to 'pdk')
-rw-r--r--pdk/docs/source/code-lines.jd7
-rw-r--r--pdk/docs/source/submit-patches.jd23
2 files changed, 27 insertions, 3 deletions
diff --git a/pdk/docs/source/code-lines.jd b/pdk/docs/source/code-lines.jd
index 5e3c91f0a..5ceb103a3 100644
--- a/pdk/docs/source/code-lines.jd
+++ b/pdk/docs/source/code-lines.jd
@@ -23,8 +23,11 @@ the source tree.</li>
stack is pulling code. These include obvious projects such as the Linux kernel
and WebKit, but over time we are migrating some of the semi-autonomous
Android projects (such as Dalvik, the Android SDK tools, Bionic, and so on) to
-work as "upstream" projects. These will be developed entirely in the public
-tree, and snapshots will be periodically pulled into releases.</li>
+work as "upstream" projects. Generally, these projects are developed entirely in
+the public tree. For some upstream projects, development is done by contributing
+directly to the upstream project itself. See
+<a href="{@docRoot}source/submit-patches.html#upstream-projects">Upstream Projects</a>
+for details. In both cases, snapshots will be periodically pulled into releases.</li>
<li>The diagram refers to "Eclair" and "FroYo"; however, they are simply
placeholders, and the diagram actually reflects the overall release and
branching strategy.</li>
diff --git a/pdk/docs/source/submit-patches.jd b/pdk/docs/source/submit-patches.jd
index 2b7bae1e1..b9b11fada 100644
--- a/pdk/docs/source/submit-patches.jd
+++ b/pdk/docs/source/submit-patches.jd
@@ -14,6 +14,9 @@ href="{@docRoot}source/life-of-a-patch.html">Life of a Patch</a>.</li>
Open Source community, see <a href="{@docRoot}source/roles.html">Project roles</a>.</li>
<li>If you plan to contribute code to the Android platform, be sure to read
the <a href="{@docRoot}source/licenses.html">AOSP's licensing information</a>.</li>
+<li>Note that changes to some of the upstream projects used by Android should be
+made directly to that project, as described in
+<a href="#upstream-projects">Upstream Projects</a>.
</ul>
<h2>
Working with the code</h2>
@@ -142,6 +145,24 @@ who plays them, see <a href="{@docRoot}source/roles.html">Project roles</a>
.<br><br><h2>
Using GitWeb to track patch histories</h2>
To view snapshots of the files that are in the public Android repositories and view file histories, use the <a href="http://android.git.kernel.org/">Android instance of GitWeb</a>
-.<br></div>
+.<br>
+<h2><a name="upstream-projects"></a>Upstream Projects</h2>
+Android makes use of a number of other open-source projects, such as the Linux
+kernel and WebKit, as described in
+<a href="{@docRoot}source/code-lines.html">Branches &amp Releases</a>. For the
+upstream projects detailed below, changes should be made directly upstream. Such
+changes will be incorporated into the Android tree as part of the usual process
+of pulling these projects.
+<h3>WebKit</h3>
+All changes to the WebKit project at <code>external/webkit</code> should be made
+upstream at <a href="http://www.webkit.org">http://www.webkit.org</a>. The
+process begins by filing a WebKit bug. This bug should use <code>Android</code>
+for the <code>Platform</code> and <code>OS</code> fields only if the bug is
+specific to Android. Bugs are far more likely to receive the reviewers'
+attention once a proposed fix is added and tests are included. See
+<a href="http://webkit.org/coding/contributing.html">Contributing Code to
+WebKit</a> for details.
+<br>
+</div>
</div>
</div>