aspnet-internationalization icon indicating copy to clipboard operation
aspnet-internationalization copied to clipboard

Documentation

Open csainty opened this issue 13 years ago • 1 comments

I followed through the readme, but still had to dig into the code a few times.

First problem was that I didn't think it was clear the code expected the resource file to be called Language.resx https://github.com/Code52/aspnet-internationalization/blob/master/src/Code52.i18n.MVC/NuSpec/Content/App_Readme/Code52.i18n.MVC.readme.txt.pp#L14

The code that expects this to be the name is here https://github.com/Code52/aspnet-internationalization/blob/master/src/Code52.i18n.MVC/NuSpec/Content/Controllers/LanguageController.cs.pp#L52

Second problem is that it does not explain how to go about configuring your supported cultures. There is this code https://github.com/Code52/aspnet-internationalization/blob/master/src/Code52.i18n.MVC/NuSpec/Content/Controllers/LanguageController.cs.pp#L14

This code https://github.com/Code52/aspnet-internationalization/blob/master/src/Code52.i18n.MVC/NuSpec/Content/Code52.i18n/CultureHelper.cs.pp#L18

And this code https://github.com/Code52/aspnet-internationalization/blob/master/src/Code52.i18n.MVC/NuSpec/Content/Views/Shared/LanguageSelection.ascx#L13

All of which seem to be defining what the supported list of cultures are, none of those lists match and none of the docs explain which ones to change.

csainty avatar Mar 19 '12 04:03 csainty

I'll start a PR on this, as there's a few places that we can/should use for this information

  • gh-pages branch - first time users, is that a better spot for documentation after install?
  • App_Readme file - doesn't always appear to users after installing package due to EnvDTE reloading the csproj file
  • README.md in repository root - what should live here?

shiftkey avatar Mar 25 '12 11:03 shiftkey