docs: update install, contrib, and usage documentationI6f4b5f5ca73780cecf66a553cce80aa3f75df2ce

This change refactors documentation, especially //:README.md,
//:CONTRIBUTING.md, and centralized most of the rest of the contributing
and usage documentation into `//doc`.

Documentation changes focus on cleaning up erroneous language,
reformatting, and restructuring docs in order to reduce visual noise -
the goals are to enable users and contributors to find what they're looking
for much more quickly, reduce (sometimes erroneous) duplication, and
present a structured approach for where to put docs.

Additionally:

- Added CI pipeline badge for the `trunk` workflow in `//:README.md`
- Converted embedded emoji characters to GitHub's emoji syntax
- Moved most sections with image and installation instructions into
  `<details>` elements
- Replaced references to gitter with matrix
- Introduced `treefmt-nix` to `devShells.default` in the flake, and all
  non-generated documentation was formatted with `nix fmt` (running
  `mdformat` under the hood)
- Regenerated //doc/md and //doc/man and refactored inline docs from various
  pages that were iterating out command line details so that they simply
  point to //doc/md instead
- Rewrote contributing docs to focus on using `nix`, to ensure that the
  development shell is used. This enforces consistency across different
  platforms with the revision and configuration of each tool we use, and
  simplifies the onboarding story for contributors -- they only need to
  install and configure nix (and optionally direnv). A dev container
  will be provided in the future [0] as an alternative for users on
  Windows (who can use WSL) or want to avoid installing `nix`.

[0]: https://github.com/git-bug/git-bug/issues/1364

Closes: #1212 #1276 #1330 #1357
Change-Id: I6f4b5f5ca73780cecf66a553cce80aa3f75df2ce

2 files changed, 7 insertions, 7 deletions

diff --git a/bridge/gitlab/export_test.go b/bridge/gitlab/export_test.go
index 6846cb21..8098c1d0 100644
--- a/bridge/gitlab/export_test.go
+++ b/bridge/gitlab/export_test.go
@@ -182,12 +182,12 @@ func TestGitlabPushPull(t *testing.T) {
 	fmt.Println("created repository", projectName)
 
 	// Make sure to remove the Gitlab repository when the test end
-	defer func(t *testing.T) {
-		if err := deleteRepository(context.TODO(), projectID, token); err != nil {
-			t.Fatal(err)
-		}
-		fmt.Println("deleted repository:", projectName)
-	}(t)
+	// defer func(t *testing.T) {
+	// 	if err := deleteRepository(context.TODO(), projectID, token); err != nil {
+	// 		t.Fatal(err)
+	// 	}
+	// 	fmt.Println("deleted repository:", projectName)
+	// }(t)
 
 	interrupt.RegisterCleaner(func() error {
 		return deleteRepository(context.TODO(), projectID, token)
diff --git a/bridge/gitlab/import.go b/bridge/gitlab/import.go
index b33a2179..b51b924d 100644
--- a/bridge/gitlab/import.go
+++ b/bridge/gitlab/import.go
@@ -81,7 +81,7 @@ func (gi *gitlabImporter) ImportAll(ctx context.Context, repo *cache.RepoCache,
 					continue
 				}
 				if err := gi.ensureIssueEvent(repo, b, issue, e); err != nil {
-					err := fmt.Errorf("issue event creation: %v", err)
+					err := fmt.Errorf("issue event creation: %v (%v)", err, e)
 					out <- core.NewImportError(err, entity.Id(e.ID()))
 				}
 			}