Update docs

[turtleDev]

Changes

• run the docs through a grammer check

• Add syntax highlighting for Code Examples

• replace all references to "raystack.gitbook.io" with site-local refs

• fix links in Usage section of the homepage

• remove markup symbols from Overview section of Guide with hyperlinks

• update topic name code in snippets to fix a bug with static topic names

• fix broken roadmap link

• reformat/rewrite:

  • Guides > Publishing Events > Data Formatters > Protos
  • Guides > Publishing Events > gRPC
  • Concepts > Architecture > Event Distribution
  • Guides > Troubleshooting > Publisher.
  • Guides > Monitoring

• Add information about raccoon headers to kafka config map conversion.

• under Concepts > Structure > Code Map

  • rename http to "services"
  • in workers, mention that publishers are abstracted and are no longer tightly coupled
  • in publishers: mention all supported publishers

• add client examples in quickstart

  • go
  • java
  • js
  • CLI

• Add instructions for setting up prometheus as metrics collector in Guides > Deployment

• update deployment manifest in deployment guide

  • add config for enabling prometheus metrics
  • update raccoon pod manifest to include annotations necessary for raccoon prometheus integration
  • explain why the complicated k8s setups is necessary for prometheus (kubernetes_sd_config)

• under Concepts > Architecture > Components

  • add information about Prometheus
  • add information about various publishers available in Raccoon

• Replace mentions of Kafka with Publishers.

• under Reference > Configurations add a separate header for each publisher

• rewrote Contribute > Release Process with goreleaser and ci in mind

• fix go client tests failing

• fix broken go client (Go client installation fails due to error fetching proton module #86)

• add a docker compose for quickstart so that users don't need to setup kafka

Changes Not Undertaken:

• update Diagram in Introduction page with various publishers
• update diagram to abstract out publisher at Concepts > Architecture > System Design
• fixing java client pipeline