Skip to content

nixos-test-driver-manual: add#331

Open
tfc wants to merge 1 commit into
nix-community:mainfrom
tfc:main
Open

nixos-test-driver-manual: add#331
tfc wants to merge 1 commit into
nix-community:mainfrom
tfc:main

Conversation

@tfc

@tfc tfc commented Apr 13, 2026

Copy link
Copy Markdown

No description provided.

@tfc

tfc commented Apr 14, 2026

Copy link
Copy Markdown
Author

ping @cyntheticfox is there anything i can/shall do above having the CI green?

@tfc

tfc commented Apr 27, 2026

Copy link
Copy Markdown
Author

ping @cyntheticfox what can i do to help getting this in?

@tfc

tfc commented May 16, 2026

Copy link
Copy Markdown
Author

ping @cyntheticfox i have seen that other things have been merged inbetween. Is there anything that i can do to make this PR acceptable?

@cyntheticfox cyntheticfox left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I typically go top-to-bottom in terms of PRs

Taking a look at this entry, I feel that it should be far clearer that this project isn't just "opinionated", but unofficial, though it looks to provide some very good examples 🙂

Additionally, it isn't a bad idea to link back to and improve the official docs, rather than just the underlying Nix code.

In general, I think the "manual" could use another "does this sentence make remotely any sense in context" review of both the comment flyouts (why?) and the main text (feels kinda LLM-y IMO)

@tfc

tfc commented Jul 5, 2026

Copy link
Copy Markdown
Author

@cyntheticfox: updated and pushed the changes.

About the guide style: I wrote this completely by hand (of course i used LLMs to improve the mkdocs configuration, generate the social media cards for links, etc. etc. etc.). As the maintainer of the test driver, I actually wrote big parts of the official docs too. The guide links to the official docs on purpose so I don't repeat the same text twice. Many people have thanked me for this guide, so I was surprised by your feedback.

This PR has been open for 3 months while newer ones were merged. If you don't want this guide in your awesome list, that is totally fine. But instead of arguing about impressions, let’s save time. If you have specific, constructive changes, I am happy to fix them. Otherwise, please just close the PR - you have all right to do that, but be open and fair about it please.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants