update docs for dev UX

Author: asim

.editorconfig

@@ -0,0 +1,31 @@
+# EditorConfig for go-micro
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.go]
+indent_style = tab
+indent_size = 4
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.{json,proto}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+

.gitignore

@@ -30,6 +30,7 @@ _cgo_export.*
 
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
+coverage.html
 
 # vim temp files
 *~
@@ -39,3 +40,10 @@ _cgo_export.*
 # go work files
 go.work
 go.work.sum
+
+# Build artifacts
+dist/
+bin/
+
+# IDE-specific files
+.DS_Store

CONTRIBUTING.md

@@ -19,16 +19,24 @@ Be respectful, inclusive, and collaborative. We're all here to build great softw
 # Install dependencies
 go mod download
 
+# Install development tools
+make install-tools
+
 # Run tests
-go test ./...
+make test
+
+# Run tests with race detector and coverage
+make test-coverage
 
-# Run tests with coverage
-go test -race -coverprofile=coverage.out ./...
+# Run linter
+make lint
 
-# Run linter (install golangci-lint first)
-golangci-lint run
+# Format code
+make fmt
 ```
 
+See `make help` for all available commands.
+
 ## Making Changes
 
 ### Code Guidelines

Makefile

@@ -0,0 +1,58 @@
+.PHONY: test test-race test-coverage lint fmt install-tools proto clean help
+
+# Default target
+help:
+	@echo "Go Micro Development Tasks"
+	@echo ""
+	@echo "  make test          - Run tests"
+	@echo "  make test-race     - Run tests with race detector"
+	@echo "  make test-coverage - Run tests with coverage"
+	@echo "  make lint          - Run linter"
+	@echo "  make fmt           - Format code"
+	@echo "  make install-tools - Install development tools"
+	@echo "  make proto         - Generate protobuf code"
+	@echo "  make clean         - Clean build artifacts"
+
+# Run tests
+test:
+	go test -v ./...
+
+# Run tests with race detector
+test-race:
+	go test -v -race ./...
+
+# Run tests with coverage
+test-coverage:
+	go test -v -race -coverprofile=coverage.out -covermode=atomic ./...
+	go tool cover -html=coverage.out -o coverage.html
+	@echo "Coverage report: coverage.html"
+
+# Run linter
+lint:
+	golangci-lint run
+
+# Format code
+fmt:
+	gofmt -s -w .
+	goimports -w .
+
+# Install development tools
+install-tools:
+	@echo "Installing development tools..."
+	go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
+	go install golang.org/x/tools/cmd/goimports@latest
+	go install github.com/kyoh86/richgo@latest
+	go install go-micro.dev/v5/cmd/protoc-gen-micro@latest
+	@echo "Tools installed successfully"
+
+# Generate protobuf code
+proto:
+	@echo "Generating protobuf code..."
+	find . -name "*.proto" -not -path "./vendor/*" -exec protoc --proto_path=. --micro_out=. --go_out=. {} \;
+
+# Clean build artifacts
+clean:
+	rm -f coverage.out coverage.html
+	find . -name "*.test" -type f -delete
+	go clean -cache -testcache
+

README.md

@@ -211,11 +211,19 @@ Docs: [`internal/website/docs`](internal/website/docs)
 
 Package reference: https://pkg.go.dev/go-micro.dev/v5
 
-Selected topics:
-- Getting Started: [`internal/website/docs/getting-started.md`](internal/website/docs/getting-started.md)
-- Plugins overview: [`internal/website/docs/plugins.md`](internal/website/docs/plugins.md)
-- Learn by Example: [`internal/website/docs/examples/index.md`](internal/website/docs/examples/index.md)
-- Performance Considerations: [`internal/website/docs/performance.md`](internal/website/docs/performance.md)
+**User Guides:**
+- [Getting Started](internal/website/docs/getting-started.md)
+- [Plugins Overview](internal/website/docs/plugins.md)
+- [Learn by Example](internal/website/docs/examples/index.md)
+- [Deployment Guide](internal/website/docs/deployment.md)
+
+**Architecture & Performance:**
+- [Performance Considerations](internal/website/docs/performance.md)
+- [Reflection Usage & Philosophy](internal/website/docs/REFLECTION-EVALUATION-SUMMARY.md)
+
+**Security:**
+- [TLS Security Migration](internal/website/docs/TLS_SECURITY_UPDATE.md)
+- [Security Migration Guide](internal/website/docs/SECURITY_MIGRATION.md)
 
 ## Adopters
 

internal/website/docs/quickstart.md

@@ -0,0 +1,91 @@
+# Quick Start
+
+Get up and running with go-micro in under 5 minutes.
+
+## Install
+
+```bash
+go install go-micro.dev/v5/cmd/micro@latest
+```
+
+## Create Your First Service
+
+```bash
+# Create a new service
+micro new helloworld
+cd helloworld
+
+# Review the generated code
+ls -la
+
+# Run locally with hot reload
+micro run
+
+# Test it
+curl -X POST http://localhost:8080/api/helloworld/Helloworld.Call \
+  -H "Content-Type: application/json" \
+  -d '{"name": "World"}'
+```
+
+## Next Steps
+
+- **[Full Tutorial](getting-started.md)** - In-depth guide
+- **[Examples](examples/)** - Learn by example
+- **[API Reference](https://pkg.go.dev/go-micro.dev/v5)** - Complete API docs
+- **[Deployment](deployment.md)** - Deploy to production
+
+## Common Patterns
+
+### RPC Service
+```go
+package main
+
+import "go-micro.dev/v5"
+
+type Greeter struct{}
+
+func (g *Greeter) Hello(ctx context.Context, req *Request, rsp *Response) error {
+    rsp.Message = "Hello " + req.Name
+    return nil
+}
+
+func main() {
+    service := micro.New("greeter")
+    service.Handle(new(Greeter))
+    service.Run()
+}
+```
+
+### Pub/Sub Event Handler
+```go
+import "go-micro.dev/v5"
+
+func main() {
+    service := micro.New("subscriber")
+    
+    // Subscribe to events
+    micro.RegisterSubscriber("user.created", service.Server(), 
+        func(ctx context.Context, event *UserCreatedEvent) error {
+            log.Infof("User created: %s", event.Email)
+            return nil
+        },
+    )
+    
+    service.Run()
+}
+```
+
+### Publishing Events
+```go
+publisher := micro.NewEvent("user.created", client)
+publisher.Publish(ctx, &UserCreatedEvent{
+    Email: "user@example.com",
+})
+```
+
+## Get Help
+
+- **[Discord Community](https://discord.gg/jwTYuUVAGh)** - Chat with other users
+- **[GitHub Issues](https://github.com/micro/go-micro/issues)** - Report bugs or request features
+- **[Documentation](https://go-micro.dev/docs/)** - Complete docs
+