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

Use the 'commented' field tag option to generate an example configuration #147

Open
michaelvanstraten opened this issue Aug 23, 2024 · 3 comments
Assignees
Labels
enhancement New feature or request

Comments

@michaelvanstraten
Copy link

What would you like sesh to do?

I've noticed that there isn't any documentation on the config options for the sesh.toml file. Fortunately, go-toml supports 'commented' field tags, which allow you to annotate config structs with comments explaining their purpose.

We could add a new CLI option that generates an example config and then outputs that config to a file or to standard output. This would enable tools like home-manager to parse the example and generate a documented home-manager module.

@joshmedeski
Copy link
Owner

This is a great idea, thanks for sharing the resources.

If you're willing to submit a PR I can take it from there. Otherwise I'll put it on my list of things to do.

@michaelvanstraten
Copy link
Author

michaelvanstraten commented Aug 24, 2024

If you're willing to submit a PR I can take it from there. Otherwise I'll put it on my list of things to do.

I’m prepared to implement the new sub-command to generate the example config, but it would be incredibly helpful if you could provide the doc strings for the comments. I’m not deeply familiar with the sesh codebase, and your expertise would be invaluable in ensuring accuracy.

@joshmedeski joshmedeski moved this to Next in OSS Development Aug 26, 2024
@michaelvanstraten
Copy link
Author

I've taken the liberty to add a home-manager module for sesh nix-community/home-manager#5789, maybe we can add it to the README when it's been merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Status: Backlog
Development

No branches or pull requests

2 participants