docs(tutorial): Expand the default_value_t example

[nicholasbishop]

There are a lot of attributes for setting defaults, and it may not be immediately obvious how to set defaults for types like String and PathBuf. Update the example to show each of the attributes for setting defaults.

[epage]

The tutorial is not generally meant to be exhaustive like this. I'm inclined to close this.

[nicholasbishop]

I'm not sure what the right solution is, but as a user of the API I'll note that default values are a particularly tricky part, especially relative to how common the desire to set default values is. The names are not obvious in that there's no way to intuit what the difference is between default_value and default_value_t.

Personally I think it's worth giving more space to it in the documentation. At the very least, I think it's worth framing the question as "how can we make this clearer" rather than "is the tutorial meant to include this".

[epage]

Personally I think it's worth giving more space to it in the documentation. At the very least, I think it's worth framing the question as "how can we make this clearer" rather than "is the tutorial meant to include this".

Yes, the documentation can and should be improved. The question isn't about the intent of this PR but how to do it. Writing documentation is hard, probably the hardest area for drive by contributions. You need to balance clarity for the end-user, technical correctness, and narrative. Just dumping more stuff in there isn't the eight way to handle this.

[nicholasbishop]

Fair enough, thanks for taking a look.