Can we make documentation apply the "Keep It Stupid Simple" principle? #3178
Comments
Same issue. |
I would very much appreciate if someone would spend the time to make the docs better. But we are both very busy with "real" work right now. If you - or @LindaLawton - want to take a stab at it, that would be cool. The "reference" code can be found here: |
I am happy to shine up some of the tutorials. @leastprivilege do you know if the samples are running the most recent version of .net core? and Ids? do they need upgrading? |
Do we still want to use HTTP instead of setting this up to run HTTPS from the start? |
@LindaLawton I appreciate the work you're doing to help people like me to start understanding and hopefully using Identity Server. Also, I vote if possible for all guides to use HTTPS since that is likely the setup for every user of IS unless there are significant / material reasons to stick with HTTP only. |
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. |
Any updates on this? |
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. |
Any updates on this? |
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. |
This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs. |
Question / Steps to reproduce the problem
Code examples on documentation page are ambiguous for beginners.
For example, compare this page:
to this page:
You will notice the second one (passwords) has example code, but doesn't say where to put the sample code. In short, it presumes a lot. Other pages do this as well.
Suggestions for Improvement
As one who had worked as a manager of customer support and led documentation efforts, I strongly encourage (and honestly , would greatly benefit from) an effort to update all coding examples to explicitly state where the code is to be applied each time. (PS: I know this can't happen everywhere immediately.)
Sometimes this could be added as follows:
In short, for people like me, new to backend work, especially in dotnet, it would be helpful if all documentation includes every step and presumes nothing.
The benefit of this is two-fold:
The text was updated successfully, but these errors were encountered: