Doc update for scip-python (#389)

Summary: Pull Request resolved: #389

Reviewed By: LivewareIssue

Differential Revision: D51246608

Pulled By: donsbot

fbshipit-source-id: bd85921aa62753abb2f22d3f3eccecfd3703337b

README.md

@@ -42,17 +42,18 @@ We also support the [SCIP](https://github.com/sourcegraph/scip) or [LSIF](https:
 * [Go](https://glean.software/docs/indexer/lsif-go)
 * [TypeScript](https://glean.software/docs/indexer/lsif-typescript)
 * [Java](https://glean.software/docs/indexer/lsif-java)
+* [Python](https://glean.software/docs/indexer/scip-python)
 
-Indexers for these languages exist but aren't in the open source
-release yet; we hope to make these available in the future:
+Custom indexers for these languages exist but aren't in the open source release
+yet; we hope to make these available in the future:
 
 * Python
-* Objective-C
 * Java
 * Kotlin
 * Erlang
 * Thrift
-* Buck
+* Buck and Bazel
+* C#
 
 ## License
 

glean/website/docs/indexer/python-scip.md

@@ -0,0 +1,45 @@
+---
+id: scip-python
+title: Python
+sidebar_label: Python
+---
+
+import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
+import {SrcFile,SrcFileLink} from '@site/utils';
+
+To index [Python](https://www.python.org) we use SourceGraph's [SCIP indexer for python](https://github.com/sourcegraph/scip-python). [SCIP](https://about.sourcegraph.com/blog/announcing-scip) is a new format for tools to share information about code. Releases of [scip-python](https://github.com/sourcegraph/scip-python) can be installed with `yarn` or `npm` and used as indexers for SCIP, which Glean will accept. The indexer itself requires a [python](https://www.python.org) runtime.
+
+## Run the indexer
+
+The indexer is run via the main `glean` CLI tool.
+
+```
+> cabal build exe:glean
+```
+
+And index your Python repository with:
+```
+glean index scip-python DIR --db NAME/INSTANCE
+```
+
+where
+
+* `DIR` is the root directory containing the Python project
+* `name/hash` is the name of the repository to create
+
+Provide the usual `--db-root` and `--schema` or `--service` arguments
+to `glean`
+
+## In the shell
+
+Python source can also be indexed directly from the Glean shell:
+
+```
+:index scip-python DIR
+```
+
+The shell will pick a DB name and hash for you based on `DIR`.
+
+## Schema
+
+The schema is in <SrcFile file="glean/schema/source/scip.angle" />

glean/website/sidebars.js

@@ -80,6 +80,7 @@ module.exports = {
                    'indexer/lsif-go',
                    'indexer/lsif-rust',
                    'indexer/lsif-java',
+                   'indexer/scip-python',
 
                ],
            },