Index: site/dev/tools/codesearch.md |
diff --git a/site/dev/tools/codesearch.md b/site/dev/tools/codesearch.md |
new file mode 100644 |
index 0000000000000000000000000000000000000000..06c41a70cea8f34a36492ddd8811d8bf674462a5 |
--- /dev/null |
+++ b/site/dev/tools/codesearch.md |
@@ -0,0 +1,44 @@ |
+Code Search |
+=========== |
+ |
+There are a number of ways to search the Skia codebase, each with advantages and |
+disadvantages. |
+ |
+[cs.skia.org](http://cs.skia.org) redirects to |
+[Chromium code search](https://code.google.com/p/chromium/codesearch) restricted |
+to the Skia portion of the Chromium tree. You can add a query after the slash; |
+e.g. [cs.skia.org/foo](http://cs.skia.org/foo) will search for "foo" within the |
+Skia tree. Chromium code search provides cross-references, but not |
+history/blame. |
+ |
+For Googlers, there is also the option of |
+[the skia depot](https://cs.corp.google.com/#skia/) in internal Code Search. In |
+addition to the main [skia](https://cs.corp.google.com/#skia/skia/) repo, |
+internal Code Search indexes the |
+[buildbot](https://cs.corp.google.com/#skia/buildbot/), |
+[common](https://cs.corp.google.com/#skia/common/), and |
+[skia_internal](https://cs.corp.google.com/#skia/skia_internal/) repos. However, |
+cross-references, history/blame, and code analysis are not available. |
+ |
+The Github mirrors of the [skia](https://github.com/google/skia) and |
+[skia-buildbot](https://github.com/google/skia-buildbot) repos are useful for |
+investigating history and blame, or for exploring release branches or other |
+branches. However, the search functionality is fairly limited, cross-references |
+are not available, and in history the original committer's username is replaced |
+with that person's Github username. |
+ |
+You can also navigate through the |
+[Skia repos on googlesource.com](https://skia.googlesource.com/). All commits |
+appear here first. |
+ |
+ Code search option |Search |XRef |History |Repos |Branches |Freshness |
+ --------------------|-------|-----|--------|------------------------------|---------|---------------------- |
+ [cs.skia.org][1] |regexp | yes |no |skia |master |last DEPS roll + hours |
+ [Internal][2] |regexp | no |no |skia buildbot common internal |master |hours |
+ [Github][3] |basic | no |yes |skia buildbot |all |hour |
+ [googlesource][4] |none | no |yes |all |all |N/A |
+ |
+[1]: http://cs.skia.org/ "Chromium code search" |
+[2]: https://cs.corp.google.com/#skia/ "Internal Code Search" |
+[3]: https://github.com/google/skia "Github mirror of skia" |
+[4]: https://skia.googlesource.com/ "Master Skia repos on googlesource.com" |