Add user directories section

[alexveecle]

From #139.

[djc]

So why did you decide to show dirs over directories? It feels to me like the directories API is a bit more modular and higher-level which probably makes more sense for our intended audience.

[alexveecle]

From #139 (reply in thread)

probably for dirs with directories mentioned in the notes (HTML links work in notes sections)

But I really don't have a strong opinion. Personally, being able to construct a nice path for my application with directories looks nice.

[nicoburns]

From #139 (reply in thread)

probably for dirs with directories mentioned in the notes (HTML links work in notes sections)

But I really don't have a strong opinion. Personally, being able to construct a nice path for my application with directories looks nice.

I also don't really have a strong opinion on this. I'd be tempted to list both as "recommendations" (noting that dirs is slightly lower-level and directories slightly higher level) and stick etcetera under "see also".

Tbh, it looks like dirs and directories crates really ought to be one crate. They're both tiny wrappers around dirs-sys.

[djc]

I also don't really have a strong opinion on this. I'd be tempted to list both as "recommendations" (noting that dirs is slightly lower-level and directories slightly higher level) and stick etcetera under "see also".

This sounds good to me.

Tbh, it looks like dirs and directories crates really ought to be one crate. They're both tiny wrappers around dirs-sys.

Agreed.

[alexveecle]

Sorry, it's been a busy period. I tried to capture the latest suggestions here. Feel free to just overwrite with any wording you prefer- I'm also happy to apply any suggestions.

[nicoburns]

Thanks!