Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation Need's Fixing | Structural #50

Open
Pairadux opened this issue Mar 23, 2024 · 5 comments
Open

Documentation Need's Fixing | Structural #50

Pairadux opened this issue Mar 23, 2024 · 5 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@Pairadux
Copy link
Contributor

When I initially began using this plugin, as someone with no experience with tmux, I found it very hard to understand the configuration options for this project and I found it hard to understand various small details. My suggestion would be to update this project with improved documentation so that it is easier for newcomers who love the tokyo-night theme like myself to get started with it.

@janoamaral janoamaral self-assigned this Mar 24, 2024
@janoamaral janoamaral added the documentation Improvements or additions to documentation label Mar 24, 2024
@janoamaral
Copy link
Owner

It's true, it's rapidly growing and we need better documentation. There is a related issue (#10). I have to find time to make it right.

@Pairadux
Copy link
Contributor Author

I would love to help out with this issue. I would have no issue updating the structure and readability of the README.

@janoamaral
Copy link
Owner

I greatly value your help. I’ve recently established a wiki for this project, which I’m confident will enhance the documentation’s readability. The structure is organized as follows: the home page presents the general settings and an overview of the project. Each widget is detailed on its own page, complete with a dedicated configuration section. If a widget require particular dependencies, these will be documented as well. I'll make you collaborator so you can edit the pages.

@Pairadux
Copy link
Contributor Author

Thank you, I will begin with updating the README, given that it is "front and center", and then move onto the wiki when I feel that the README is sufficient.

@Stealthii
Copy link
Contributor

Stealthii commented Apr 12, 2024

The requirements section has been flattened into a list, with sections for OS specific instructions via a91e24b, with heading and grammatical improvements in ec66aa3, both part of #63.

This is not a complete overhaul to the documentation as it is out-of-scope for the PR, but should improve readability, especially the requirements in the meantime.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants