confluentinc / confluentinc/schema-registry

docs should emphasize simplicity of schema-registry service

Open
#147 3 comments 0 reactions 0 assignees View on GitHub
documentation
Dominant language
Java
Stars
2.5k
Forks
1.2k
Avg merge
23h 27m
Merged PRs (30d)
65

Description

Quoting @ewencp,
"I think the bigger takeaway here is that we need to be clear in our documentation that the schema registry should be extremely low maintenance. Instead of thinking "oh man, now I have to maintain 3 important services instead of 2", it should be "I just have to keep a couple of instances of this running and I get all these awesome benefits of using schemas". Maybe there are some changes in the documentation that we can make to make it very clear that high availability for this service should just be a matter of keeping a couple of processes running."

Contributor guide

No contributing guide indexed for this repository

Research direction

The issue does not name a documentation file or test. Begin by locating the schema-registry service's deployment and high-availability documentation; done means those docs clearly present the service as low-maintenance and explain that high availability comes from running a couple of instances.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.