Talk:Flakes: Difference between revisions
imported>Sid-code No edit summary |
→Making it more legible for newcomers: new section |
||
| Line 14: | Line 14: | ||
I noticed that a lot of people complain that flakes are hard to understand. The first paragraph of this article used to be very confusing and didn't really capture what I feel flakes are truly about. I've rewritten it to be more direct about the local locking of dependencies, which is what I see as the truly essential flake feature. -- [[User:Sid-code]] | I noticed that a lot of people complain that flakes are hard to understand. The first paragraph of this article used to be very confusing and didn't really capture what I feel flakes are truly about. I've rewritten it to be more direct about the local locking of dependencies, which is what I see as the truly essential flake feature. -- [[User:Sid-code]] | ||
== Making it more legible for newcomers == | |||
There are a couple of changes I'd love to see to start, but the whole article overall needs a revamp. | |||
1. A section explaining how flakes are relevant for desktop use | |||
2. A basic example flake for people to look at and use on their own system, with comments explaining what each line does | |||
There will come a time when flakes aren't experimental, and such widely used features will need good, easy to understand documentation. | |||