Use md-to-godoc

Makefile

@@ -26,8 +26,12 @@ COLORIZE=sed ''/PASS/s//$(PASS)/'' | sed ''/FAIL/s//$(FAIL)/''
 .PHONY: test-and-lint
 test-and-lint: test fmt lint
 
+.PHONY: go-gen
+go-gen:
+	go generate ./...
+
 .PHONY: test
-test:
+test: go-gen
 	$(GOTEST) $(PACKAGES) | $(COLORIZE)
 
 .PHONY: fmt
@@ -61,6 +65,7 @@ install_ci: install
 	go get github.com/mattn/goveralls
 	go get golang.org/x/tools/cmd/cover
 	go get github.com/golang/lint/golint
+	go get github.com/sectioneight/md-to-godoc
 
 
 .PHONY: test_ci

README.md

@@ -6,13 +6,17 @@
 
 http://uber.github.io/jaeger/
 
+## Status
+
+We are in the process of moving Jaeger backend code from internal repositories to GitHub.
+
 ## Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md).
+See [CONTRIBUTING](./CONTRIBUTING.md).
 
 ## License
 
-[The MIT License](./LICENSE)
+[The MIT License](./LICENSE).
 
 [doc-img]: https://readthedocs.org/projects/jaeger/badge/?version=latest
 [doc]: http://jaeger.readthedocs.org/en/latest/

scripts/updateLicenses.sh

@@ -1,6 +1,5 @@
 #!/bin/bash
 
 set -e
-#set -x
 
 python scripts/updateLicense.py $(go list -json $(glide nv) | jq -r '.Dir + "/" + (.GoFiles | .[])')

services/agent/README.md

@@ -1,4 +1,5 @@
-Package agent implements `jaeger-agent` sidecar service. It is meant
-to run on each host that runs the services instrumented with Jaeger.
+# `jaeger-agent` sidecar service
+
+Agent is meant to run on each host that runs the services instrumented with Jaeger.
 Jaeger client libraries send tracing spans to `jaeger-agent`. The agent
 forwards the spans to `jaeger-collector` services for storing in the DB.

services/agent/doc.go

@@ -18,8 +18,12 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package agent implements jaeger-agent sidecar service. It is meant
-// to run on each host that runs the services instrumented with Jaeger.
-// Jaeger client libraries send tracing spans to jaeger-agent. The agent
-// forwards the spans to jaeger-collector services for storing in the DB.
+/*
+Package agent is the jaeger-agent sidecar service.
+
+Agent is meant to run on each host that runs the services instrumented with Jaeger.
+Jaeger client libraries send tracing spans to jaeger-agent. The agent
+forwards the spans to jaeger-collector services for storing in the DB.
+
+*/
 package agent

services/agent/md2doc.go

@@ -0,0 +1,26 @@
+// Copyright (c) 2016 Uber Technologies, Inc.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+// This file only exists to generate doc.go from README.md
+
+//go:generate md-to-godoc
+//go:generate python ../../scripts/updateLicense.py doc.go
+
+package agent