Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing Instructions #1050

Open
rgamage opened this issue May 19, 2023 · 0 comments
Open

Missing Instructions #1050

rgamage opened this issue May 19, 2023 · 0 comments

Comments

@rgamage
Copy link

rgamage commented May 19, 2023

The docs don't describe or explain many of the necessary tasks to actually get this app deployed and running in a real environment. For example:

  1. You need to find a secure storage solution for your IdentityServer certificate, and make changes to ServiceCollectionExtensions.cs to implement it. Without this you will get a runtime error, not finding the temp dev rsa key.
    .AddDeveloperSigningCredential(); // not recommended for production - you need to store your key material somewhere secure
  2. The app won't run without the SampleData sql, and it's ignored by git. No guidance on how to resolve this or how to replace with your own product data. I had to comment out the .gitignore file in the sample data directory.
  3. Home page, when deployed, gives users the Admin username and Password, and link to Dashboard. This should be mentioned in the docs!!! This widget needs to be deleted in the Admin site immediately upon deployment, and you need to create a new Admin user for yourself, and delete the default one.
  4. Home page also allows users to delete all data and load SampleData. Again all of this should be explained in the Getting Started or Developers guide in the docs, but I could find no mention of these required steps to get the app running.
  5. A new install for culture of en-US results in only one of the 50 US states configured, Washington state. I don't know why all the states are not loaded, but there should be something in the docs on how to enable the other states.

I would be happy to contribute to the documentation, just tell me the best way (fork the repo, then create a PR?), and I can assist.

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

No branches or pull requests

1 participant