WayfireWM / WayfireWM/wayfire

Improve the wiki debugging guide

Open
#2,950 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement low-priority
Dominant language
C++
Stars
3.1k
Forks
237
Avg merge
1h 43m
Merged PRs (30d)
1

Description

I think the wiki debugging guide could be improved to better support newcomers. Adding concrete examples and common troubleshooting steps would make it much easier to follow. For reference, the debugging documentation in ammen tools is quite helpful, we could either adapt parts of it or use it as inspiration to create something even clearer and more comprehensive.

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

Start by reading the existing wiki debugging guide at the linked page, then review the ammen-tools debugging documentation for useful patterns. Add concrete examples and common troubleshooting steps that make the guide easier for newcomers to follow; done means the wiki is clearer and more comprehensive without relying on unstated project knowledge.

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
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.