diff --git a/Makefile b/Makefile
index 020a1c8..dd72cdd 100644
--- a/Makefile
+++ b/Makefile
@@ -20,8 +20,7 @@ PROTOC_GEN_VALIDATE_PROTO=${SUBMODULES_DIR}/protoc-gen-validate
 GOOGLE_OPENAPI_PROTO=${SUBMODULES_DIR}/gnostic/openapiv3
 PROTO_OPTION=-I. -I${SUBMODULES_DIR} -I${GOOGLEAPIS_PROTO} -I${GOOGLEPROTOBUF_PROTO} -I${PROTOC_GEN_VALIDATE_PROTO} -I${GOOGLE_OPENAPI_PROTO}
 PROTO_DOCS_OPTS=${PROTO_OPTION} \
-	--plugin=protoc-gen-doc=${BIN_DIR}/protoc-gen-doc \
-	--doc_out=./docs
+	--plugin=protoc-gen-doc=${BIN_DIR}/protoc-gen-doc
 
 # GO
 PROTOC_GO_OPTS=${PROTO_OPTION} \
@@ -112,23 +111,23 @@ clean/go:
 	@rm -rf ${GEN_GO_DIR}
 
 .PHONY: release/go
-release/go: proto docs
+release/go: proto
 	@echo "Publishing go client..."
 	@rm -rf ${TMP_REPO_DIR} && mkdir -p ${TMP_REPO_DIR}
 	@git clone ${REPO}-go.git ${TMP_REPO_DIR}/client-go
 	@cd ${TMP_REPO_DIR}/client-go && git clean -fdx #&& git checkout main
 	@cp $(PWD)/scripts/go/go.mod ${TMP_REPO_DIR}/client-go/go.mod
-	@cp $(PWD)/docs/README.md ${TMP_REPO_DIR}/client-go/README.md
+	#@cp $(PWD)/docs/README.md ${TMP_REPO_DIR}/client-go/README.md
 	@cp $(PWD)/CHANGELOG.md ${TMP_REPO_DIR}/client-go/CHANGELOG.md
-	@cp -R $(PWD)/gen/go/src ${TMP_REPO_DIR}/client-go
+	@cp -R $(PWD)/gen/go ${TMP_REPO_DIR}/client-go
+	@rm -rf ${TMP_REPO_DIR}/client-go/**openapi**.*
 	@$(eval NEXT_VERSION=$(shell test $(NEXT_VERSION) && echo $(NEXT_VERSION) || echo $(LAST_TAG)))
 	@cd ${TMP_REPO_DIR}/client-go && git add . && git commit -m "bump(version): $(NEXT_VERSION)" && git tag -a $(NEXT_VERSION) -m '$(NEXT_VERSION)' && git push --tags origin main
 
 .PHONY: docs
 docs:
 	@echo "Generating docs..."
-	@rm -rf docs && mkdir -p docs
-	@find proto -name '*.proto' -print0 | xargs -0 -I{} -P${CPUS} protoc ${PROTO_DOCS_OPTS} --doc_opt=markdown,README.md {}
+	find proto -name '*.proto' -printf '%h\0' | sort -zu | xargs -0 -I{} -P${CPUS} bash -c "d={}; protoc ${PROTO_DOCS_OPTS} --doc_opt=./scripts/markdown.tmpl,README.md:google/* --doc_out=hoguera/platform/"'$$d'" hoguera/platform/"'$$d'"/*.proto"
 
 
 LINT_PLUGIN=${BIN_DIR}/protoc-gen-lint
@@ -143,7 +142,7 @@ fmt:
 	@find proto -type f -name "*.proto" | xargs -I{} -P${CPUS} clang-format -i {}
 
 .PHONY: changelog
-changelog:
+changelog: docs
 	@echo "Generating changelog..."
 	@$(eval NEXT_VERSION=$(shell test $(NEXT_VERSION) && echo $(NEXT_VERSION) || echo $(LAST_TAG) | awk -F. '{print $$1"."$$2+1".0"}'))
 	@test $NEXT_VERSION || (echo "NEXT_VERSION is not set"; exit 1)
diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index e84b850..0000000
--- a/docs/README.md
+++ /dev/null
@@ -1,244 +0,0 @@
-# Protocol Documentation
-<a name="top"></a>
-
-## Table of Contents
-
-- [proto/api/v1/mobile.proto](#proto_api_v1_mobile-proto)
-    - [Animal](#platform-api-v1-Animal)
-    - [AnimalsRequest](#platform-api-v1-AnimalsRequest)
-    - [AnimalsResponse](#platform-api-v1-AnimalsResponse)
-    - [AreaRequest](#platform-api-v1-AreaRequest)
-    - [AreaResponse](#platform-api-v1-AreaResponse)
-    - [Location](#platform-api-v1-Location)
-    - [LocationRequest](#platform-api-v1-LocationRequest)
-    - [LocationResponse](#platform-api-v1-LocationResponse)
-    - [V1Response](#platform-api-v1-V1Response)
-  
-    - [Condition](#platform-api-v1-Condition)
-  
-    - [Bff](#platform-api-v1-Bff)
-    - [Internal](#platform-api-v1-Internal)
-  
-- [Scalar Value Types](#scalar-value-types)
-
-
-
-<a name="proto_api_v1_mobile-proto"></a>
-<p align="right"><a href="#top">Top</a></p>
-
-## proto/api/v1/mobile.proto
-
-
-
-<a name="platform-api-v1-Animal"></a>
-
-### Animal
-Animals
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| name | [string](#string) |  |  |
-| in_danger | [bool](#bool) |  |  |
-| description | [string](#string) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-AnimalsRequest"></a>
-
-### AnimalsRequest
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| location | [Location](#platform-api-v1-Location) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-AnimalsResponse"></a>
-
-### AnimalsResponse
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| animals | [Animal](#platform-api-v1-Animal) | repeated |  |
-
-
-
-
-
-
-<a name="platform-api-v1-AreaRequest"></a>
-
-### AreaRequest
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| location | [Location](#platform-api-v1-Location) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-AreaResponse"></a>
-
-### AreaResponse
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| name | [string](#string) |  |  |
-| condition | [Condition](#platform-api-v1-Condition) |  |  |
-| temperature | [float](#float) |  |  |
-| distance | [double](#double) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-Location"></a>
-
-### Location
-Location
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| longitude | [int32](#int32) |  |  |
-| latitude | [int32](#int32) |  |  |
-| name | [string](#string) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-LocationRequest"></a>
-
-### LocationRequest
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| ip | [string](#string) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-LocationResponse"></a>
-
-### LocationResponse
-
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| location | [Location](#platform-api-v1-Location) |  |  |
-
-
-
-
-
-
-<a name="platform-api-v1-V1Response"></a>
-
-### V1Response
-BFF
-
-
-| Field | Type | Label | Description |
-| ----- | ---- | ----- | ----------- |
-| location | [Location](#platform-api-v1-Location) |  |  |
-| nearest_aquatic_location | [AreaResponse](#platform-api-v1-AreaResponse) |  |  |
-| animals | [Animal](#platform-api-v1-Animal) | repeated |  |
-
-
-
-
-
- 
-
-
-<a name="platform-api-v1-Condition"></a>
-
-### Condition
-Area
-
-| Name | Number | Description |
-| ---- | ------ | ----------- |
-| GOOD | 0 |  |
-| MODERATE | 1 |  |
-| CONTAMINATED | 2 |  |
-| UNKNOWN | 3 |  |
-| RADIATION | 4 |  |
-| DANGER | 5 |  |
-| PROTECTED | 6 |  |
-
-
- 
-
- 
-
-
-<a name="platform-api-v1-Bff"></a>
-
-### Bff
-BFF service
-
-| Method Name | Request Type | Response Type | Description |
-| ----------- | ------------ | ------------- | ------------|
-| GetV1 | [.google.protobuf.Empty](#google-protobuf-Empty) | [V1Response](#platform-api-v1-V1Response) |  |
-
-
-<a name="platform-api-v1-Internal"></a>
-
-### Internal
-Internal service
-
-| Method Name | Request Type | Response Type | Description |
-| ----------- | ------------ | ------------- | ------------|
-| GetAnimals | [AnimalsRequest](#platform-api-v1-AnimalsRequest) | [AnimalsResponse](#platform-api-v1-AnimalsResponse) |  |
-| GetArea | [AreaRequest](#platform-api-v1-AreaRequest) | [AreaResponse](#platform-api-v1-AreaResponse) |  |
-| GetLocation | [LocationRequest](#platform-api-v1-LocationRequest) | [LocationResponse](#platform-api-v1-LocationResponse) |  |
-
- 
-
-
-
-## Scalar Value Types
-
-| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
-| ----------- | ----- | --- | ---- | ------ | -- | -- | --- | ---- |
-| <a name="double" /> double |  | double | double | float | float64 | double | float | Float |
-| <a name="float" /> float |  | float | float | float | float32 | float | float | Float |
-| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
-| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
-| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
-| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
-| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
-| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
-| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
-| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
-| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
-| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
-| <a name="bool" /> bool |  | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass |
-| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
-| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |
-
diff --git a/proto/greenspace/api/v1/README.md b/proto/greenspace/api/v1/README.md
new file mode 100644
index 0000000..1dd8aea
--- /dev/null
+++ b/proto/greenspace/api/v1/README.md
@@ -0,0 +1,207 @@
+# Documentation
+<a name="top"/>
+
+
+## Reference
+
+[hoguera/platform/proto/greenspace/api/v1/mobile.proto](#hoguera/platform/proto/greenspace/api/v1/mobile.proto)
+<details>
+<summary>Click to show</summary>
+
+### Messages
+  - [Animal](#hoguera.platform.greenspace.api.v1.Animal)
+  - [AnimalsRequest](#hoguera.platform.greenspace.api.v1.AnimalsRequest)
+  - [CoastRequest](#hoguera.platform.greenspace.api.v1.CoastRequest)
+  - [CoastResponse](#hoguera.platform.greenspace.api.v1.CoastResponse)
+  - [LocationRequest](#hoguera.platform.greenspace.api.v1.LocationRequest)
+  - [LocationResponse](#hoguera.platform.greenspace.api.v1.LocationResponse)
+  - [V1Response](#hoguera.platform.greenspace.api.v1.V1Response)
+
+### Enums
+  - [Condition](#hoguera.platform.greenspace.api.v1.Condition)
+
+
+</details>
+
+
+
+## Services
+
+
+<a name="hoguera.platform.greenspace.api.v1.Bff"/>
+
+### Bff
+BFF service
+
+| Method Name | Description |
+| ----------- | ------------|
+| `GetV1` <br /><br /> Request: [.google.protobuf.Empty](#google.protobuf.Empty) <br /> Response: [V1Response](#google.protobuf.Empty) | <para></para> |
+
+
+<a name="hoguera.platform.greenspace.api.v1.Internal"/>
+
+### Internal
+Internal service
+
+| Method Name | Description |
+| ----------- | ------------|
+| `GetAnimals` <br /><br /> Request: [AnimalsRequest](#hoguera.platform.greenspace.api.v1.AnimalsRequest) <br /> Response: [Animal](#hoguera.platform.greenspace.api.v1.AnimalsRequest) | <para></para> |
+| `GetCoast` <br /><br /> Request: [CoastRequest](#hoguera.platform.greenspace.api.v1.CoastRequest) <br /> Response: [CoastResponse](#hoguera.platform.greenspace.api.v1.CoastRequest) | <para></para> |
+| `GetLocation` <br /><br /> Request: [LocationRequest](#hoguera.platform.greenspace.api.v1.LocationRequest) <br /> Response: [LocationResponse](#hoguera.platform.greenspace.api.v1.LocationRequest) | <para></para> |
+
+ <!-- end services -->
+ <!-- end files -->
+
+
+
+<a name="hoguera/platform/proto/greenspace/api/v1/mobile.proto"/>
+<p align="right"><a href="#top">Top</a></p>
+
+## hoguera/platform/proto/greenspace/api/v1/mobile.proto
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.Animal"/>
+
+### Animal
+Animals
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| name | [string](#string) |  | <para></para> |
+| in_danger | [bool](#bool) |  | <para></para> |
+| description | [string](#string) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.AnimalsRequest"/>
+
+### AnimalsRequest
+*Description comment will be shown here (markdown supported)*
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| location | [LocationResponse](#hoguera.platform.greenspace.api.v1.LocationResponse) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.CoastRequest"/>
+
+### CoastRequest
+*Description comment will be shown here (markdown supported)*
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| location | [LocationResponse](#hoguera.platform.greenspace.api.v1.LocationResponse) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.CoastResponse"/>
+
+### CoastResponse
+*Description comment will be shown here (markdown supported)*
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| name | [string](#string) |  | <para></para> |
+| condition | [Condition](#hoguera.platform.greenspace.api.v1.Condition) |  | <para></para> |
+| temperature | [float](#float) |  | <para></para> |
+| distance | [double](#double) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.LocationRequest"/>
+
+### LocationRequest
+*Description comment will be shown here (markdown supported)*
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ip | [string](#string) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.LocationResponse"/>
+
+### LocationResponse
+Location
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| longitude | [int32](#int32) |  | <para></para> |
+| latitude | [int32](#int32) |  | <para></para> |
+| name | [string](#string) |  | <para></para> |
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.V1Response"/>
+
+### V1Response
+BFF
+
+
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| location | [LocationResponse](#hoguera.platform.greenspace.api.v1.LocationResponse) |  | <para></para> |
+| nearest_aquatic_location | [CoastResponse](#hoguera.platform.greenspace.api.v1.CoastResponse) |  | <para></para> |
+| animals | [Animal](#hoguera.platform.greenspace.api.v1.Animal) | repeated | <para></para> |
+
+
+
+
+
+
+
+<a name="hoguera.platform.greenspace.api.v1.Condition"/>
+
+### Condition
+Coast
+
+
+<details>
+<summary>Click to show</summary>
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| GOOD | 0 | <para></para> |
+| MODERATE | 1 | <para></para> |
+| CONTAMINATED | 2 | <para></para> |
+| UNKNOWN | 3 | <para></para> |
+| RADIATION | 4 | <para></para> |
+| DANGER | 5 | <para></para> |
+| PROTECTED | 6 | <para></para> |
+
+</details>
+
+
+ <!-- end enums -->
+
+ <!-- end HasExtensions -->
+
+
diff --git a/proto/greenspace/api/v1/mobile.proto b/proto/greenspace/api/v1/mobile.proto
index 7acb993..6ce3e08 100644
--- a/proto/greenspace/api/v1/mobile.proto
+++ b/proto/greenspace/api/v1/mobile.proto
@@ -1,8 +1,8 @@
 syntax = "proto3";
 
-package platform.api.v1;
+package hoguera.platform.greenspace.api.v1;
 
-option go_package = "src/api/v1;mobile";
+option go_package = "greenspace/api/v1;mobile";
 
 import "google/api/annotations.proto";
 import "google/protobuf/empty.proto";
diff --git a/scripts/markdown.tmpl b/scripts/markdown.tmpl
new file mode 100644
index 0000000..1676983
--- /dev/null
+++ b/scripts/markdown.tmpl
@@ -0,0 +1,127 @@
+# Documentation
+<a name="top"/>
+
+{{/* ------  Overall Reference ------ */}}
+## Reference
+{{range .Files}}
+{{$file_name := .Name}}[{{.Name}}](#{{.Name}})
+<details>
+<summary>Click to show</summary>
+
+### Messages
+{{range .Messages}}  - [{{.LongName}}](#{{.FullName}})
+{{end}}
+### Enums
+{{range .Enums}}  - [{{.LongName}}](#{{.FullName}})
+{{end}}
+{{range .Extensions}}  - [File-level Extensions](#{{$file_name}}-extensions)
+{{end}}
+</details>
+{{end}}
+
+{{/* ------  Service and Methods ------ */}}
+## Services
+{{range .Files}}
+{{range .Services}}
+<a name="{{.FullName}}"/>
+
+### {{.Name}}
+
+{{- if .Description}}
+{{.Description}}
+{{- else}}
+*Description comment will be shown here*
+{{- end}}
+
+| Method Name | Description |
+| ----------- | ------------|
+{{range .Methods -}}
+| `{{.Name}}` <br /><br /> Request: [{{.RequestLongType}}](#{{.RequestFullType}}) <br /> Response: [{{.ResponseLongType}}](#{{.RequestFullType}}) | {{para .Description | replace "|" "\\|"}} |
+{{end}}
+{{end}} <!-- end services -->
+{{end}} <!-- end files -->
+
+{{range .Files}}
+{{$file_name := .Name}}
+<a name="{{.Name}}"/>
+<p align="right"><a href="#top">Top</a></p>
+
+## {{.Name}}
+{{.Description}}
+
+{{/* ------  Messages ------ */}}
+{{- range .Messages}}
+<a name="{{.FullName}}"/>
+
+### {{.LongName}}
+
+{{- if .Description}}
+{{.Description}}
+{{- else}}
+*Description comment will be shown here (markdown supported)*
+{{- end}}
+
+{{if .HasFields}}
+#### Fields
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+{{range .Fields -}}
+  | {{.Name}} | [{{.LongType}}](#{{.FullType}}) | {{.Label}} | {{para .Description | replace "|" "\\|"}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+{{end}}
+{{end}}
+
+{{if .HasExtensions}}
+| Extension | Type | Base | Number | Description |
+| --------- | ---- | ---- | ------ | ----------- |
+{{range .Extensions -}}
+  | {{.Name}} | {{.LongType}} | {{.ContainingLongType}} | {{.Number}} | {{para .Description | replace "|" "\\|"}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+{{end}}
+{{end}}
+
+{{- end}}
+
+{{/* ------  Enums ------ */}}
+{{range .Enums}}
+<a name="{{.FullName}}"/>
+
+### {{.LongName}}
+
+{{- if .Description}}
+{{.Description}}
+{{- else}}
+*Description comment will be shown here (markdown supported)*
+{{- end}}
+
+{{$lengths := len .Values}}{{if gt $lengths 5}}
+<details>
+<summary>Click to show</summary>
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+{{range .Values -}}
+  | {{.Name}} | {{.Number}} | {{para .Description | replace "|" "\\|"}} |
+{{end}}
+</details>
+{{else}}
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+{{range .Values -}}
+  | {{.Name}} | {{.Number}} | {{para .Description | replace "|" "\\|"}} |
+{{end}}
+{{end}}
+
+{{end}} <!-- end enums -->
+
+{{if .HasExtensions}}
+<a name="{{$file_name}}-extensions"/>
+
+### File-level Extensions
+| Extension | Type | Base | Number | Description |
+| --------- | ---- | ---- | ------ | ----------- |
+{{range .Extensions -}}
+  | {{.Name}} | {{.LongType}} | {{.ContainingLongType}} | {{.Number}} | {{para .Description | replace "|" "\\|"}}{{if .DefaultValue}} Default: `{{.DefaultValue}}`{{end}} |
+{{end}}
+{{end}} <!-- end HasExtensions -->
+
+{{end}}