Bartosz Majsak

##### What can be improved At the moment we run bunch of linters against golang, which is the dominant language of this project. We do have however bunch of YAMLs,...

##### What can be improved We have introduced strategies and templates - we need some streamlined docs for that too. ##### Why Otherwise it's hidden :)

Documentation publishing

1

- [x] antora setup https://github.com/Maistra/istio-workspace/pull/113 - [x] netlify setup - [ ] custom domain (?) - [x] triggering docs build based on doc content changes (in another repo) - [...

- [ ] antora - [ ] toolchain (how to use another repo and why it exists) - [ ] build and publishing process

Improved troubleshooting / issue reporting

1

##### What can be improved Similarly to Telepresence we should guide user to report issues here with minimal effort from their side. ##### Why Otherwise we will keep asking questions...

Docs validation

2

##### What can be improved As part of CI job we should validate Antora site for missing links, images etc. ##### Why Otherwise we discover it too late or would...

See https://github.com/aslakknutsen/istio-workspace/pull/99#discussion_r276119831

Windows support

1

##### What can be improved In the current shape `istio-workspace` will not work on Windows (potentially on WSL2 though). ##### Why At least two known reasons right now - `go-cmd`...