Merge pull request #201 from MichaelMure/bridge-docs

Michael Muré created

bridge: add documentation

Change summary

README.md                    | 50 ++++++++++++++++++++++++++++++++-----
commands/bridge_configure.go | 11 ++++++-
2 files changed, 52 insertions(+), 9 deletions(-)

Detailed changes

README.md 🔗

@@ -135,13 +135,49 @@ The web UI interact with the backend through a GraphQL API. The schema is availa
 
 | | Github | Gitlab | Launchpad |
 | --- | --- | --- | --- |
-| **bug** | :heavy_check_mark: | :x: | :x: |
-| comments | :heavy_check_mark: | :x: | :x: |
-| comment editions | :heavy_check_mark: | :x: | :x: |
-| labels | :heavy_check_mark: | :x: | :x: |
-| status | :heavy_check_mark: | :x: | :x: |
-| title edition | :heavy_check_mark: | :x: | :x: |
-| **automated test suite** | :heavy_check_mark: | :x: | :x: |
+| **bug** | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| comments | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| comment editions | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| labels | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| status | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| title edition | :heavy_check_mark: | :heavy_check_mark: | :x: |
+| **automated test suite** | :heavy_check_mark: | :heavy_check_mark: | :x: |
+
+#### Bridge usage
+
+Interactively configure a new github bridge:
+
+```bash
+git bug bridge configure
+```
+
+Or manually:
+
+```bash
+git bug bridge configure \
+    --name=mybridge \
+    --target=github \
+    --url=https://github.com/michaelmure/git-bug \
+    --token=$TOKEN
+```
+
+Import bugs:
+
+```bash
+git bug bridge pull [<name>]
+```
+
+Export modifications:
+
+```bash
+git bug bridge push [<name>]
+```
+
+Deleting a bridge:
+
+```bash
+git bug bridge rm [<name>]
+```
 
 ## Internals
 

commands/bridge_configure.go 🔗

@@ -160,7 +160,7 @@ Private:
 Enter token: 87cf5c03b64029f18ea5f9ca5679daa08ccbd700
 Successfully configured bridge: default
 
-# For Github
+# For GitHub
 git bug bridge configure \
     --name=default \
     --target=github \
@@ -172,7 +172,14 @@ git bug bridge configure \
 git bug bridge configure \
     --name=default \
     --target=launchpad-preview \
-    --url=https://bugs.launchpad.net/ubuntu/`,
+	--url=https://bugs.launchpad.net/ubuntu/
+
+# For Gitlab
+git bug bridge configure \
+    --name=default \
+    --target=github \
+    --url=https://github.com/michaelmure/git-bug \
+    --token=$(TOKEN)`,
 	PreRunE: loadRepo,
 	RunE:    runBridgeConfigure,
 }