mozilla / mozilla/bugbug

Imoprove the docs for Hackbot

Open
#6,729 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

hackbot
Dominant language
Python
Stars
570
Forks
351
Avg merge
2d 13h
Merged PRs (30d)
65

Description

We should drop implementation details and keep high-level concepts and things that are not easy to grasp quickly. This includes making it more concise.

Ideally, improvements should not make the docs outdated frequently; that is a sign that we are documenting too many implementation details or documenting something that is not mature yet.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue identifies Hackbot documentation as the target but names no files, tests, or entry points. First locate the existing Hackbot docs, then remove implementation details and tighten the high-level explanation; done means the result is concise and less likely to become outdated.

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
Active
Clarity
Needs clarification
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.