BlazorConduit icon indicating copy to clipboard operation
BlazorConduit copied to clipboard

Add documentation

Open JoeyMckenzie opened this issue 5 years ago • 5 comments

Title, I seriously slacked on docs.

JoeyMckenzie avatar Jun 29 '20 16:06 JoeyMckenzie

I can give this a try. Are you looking for C# docstrings or code walkthrough of some kind in markdown?

shashwatsingh avatar Sep 05 '20 11:09 shashwatsingh

Docs are more what I was thinking, but there's always room for improvement on the READMEs (adding one to the services folder, store folder, etc.). This is a great one to tackle if you're looking to jump in, as I'm sure you'll find a few places we could definitely improve the code.

JoeyMckenzie avatar Sep 08 '20 15:09 JoeyMckenzie

I can start by outlining the project folder structure and describing the code flow given an action dispatched in the UI.

If you have some other project in mind that's close (in structure or style) to what you are looking for, let me know.

Any pointers are welcome :)

On Tue, 8 Sep 2020, 8:51 pm Joey Mckenzie, [email protected] wrote:

Docs are more what I was thinking, but there's always room for improvement on the READMEs (adding one to the services folder, store folder, etc.). This is a great one to tackle if you're looking to jump in, as I'm sure you'll find a few places we could definitely improve the code.

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/JoeyMckenzie/BlazorConduit/issues/2#issuecomment-688950124, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAFFHD3TVCGMIWKGUAHDXIDSEZDWHANCNFSM4OLLTLKA .

shashwatsingh avatar Sep 08 '20 15:09 shashwatsingh

I have put some details on https://github.com/shashwatsingh/BlazorConduit/wiki. In future if we plan to move to something like https://dotnet.github.io/docfx/index.html it would not be difficult to move these markdown pages.

I plan to take one interaction: like loading the home page, and go over the code flow. For example:

Index page event handler fired ⇒ ArticleList component loaded ⇒ Service Facade / Action dispatched ⇒ Effect ...

Please let me know if I should continue in this direction or would you recommend something else.

shashwatsingh avatar Sep 13 '20 15:09 shashwatsingh

I have added https://github.com/shashwatsingh/BlazorConduit/wiki/Code-flow

Please let me know if I should continue along these lines.

shashwatsingh avatar Sep 28 '20 05:09 shashwatsingh