canonical / canonical/ubuntu-server-documentation

[Feedback]: tidying up the kerberos introduction

Open
#533 0 comments 0 reactions 0 assignees View on GitHub
size: S
Dominant language
Makefile
Stars
88
Forks
159
Avg merge
1d 13h
Merged PRs (30d)
5

Description

### Page URL

https://documentation.ubuntu.com/server/explanation/intro-to/kerberos/#introduction-to-kerberos

### Select an option

- [ ] I found what I was looking for
- [ ] I couldn't find what I was looking for
- [x] I found the information, but it was incorrect
- [x] I found the information, but it was incomplete
- [ ] I found the information, but it was confusing
- [ ] I encountered a technical issue (e.g., broken link, image not loading)

### Issue Description

a) This paragraph at the top should be removed, because the actual installation and configuration is done elsewhere:
> This section covers installation and configuration of a Kerberos server, and some example client configurations.

b) The first sentence reads in an odd way, and is incorrect in one aspect (it's not a system, but a protocol):
> Kerberos is a network authentication system based on the principal of a trusted third party.

I suggest:
"Kerberos is a network authentication protocol based on shared secrets that provides strong authentication for client/server applications and users."

c) The resources section should drop the reference to Matrix or IRC, that is something we have for all pages in the footer.

Contributor guide

No contributing guide indexed for this repository

Research direction

Open the Kerberos introduction at the page URL and review the introduction and resources sections. Remove the installation/configuration paragraph, replace the inaccurate opening sentence with the suggested wording, and remove the Matrix or IRC reference; done means all three requested documentation changes are reflected on the page.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.