hashicorp / hashicorp/nomad

Add Known Issues Page

Open
#11,035 0 comments 2 reactions 0 assignees View on GitHub
theme/docs type/enhancement
Dominant language
Go
Stars
17k
Forks
2.1k
Avg merge
1d 9h
Merged PRs (30d)
105

Description

### Proposal

It would be helpful to have a Known Issues page added to the Nomad website. This could document the most commonly experienced bugs/issues and suggest workarounds if they exist. I'd imagine it would not be complete (as there are 900+ open issue on GH), but it could mention the ones people are most likely to run into.

### Use-cases

Nomad users who are experiencing issues can check the known issues page and easily find a workaround if one exists.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the Nomad website structure and the most commonly experienced open issues, then identify any documented workarounds. Done means a published Known Issues page that records prioritized issues and available workarounds for users.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.