Help shape the MicroProfile API Tutorial: Review our draft outline!

[Tarun Telang]

Dear MicroProfile Community Members,

I'm reaching out to get your feedback for the MicroProfile API Tutorial for Java developers, a hands-on guide to understanding and working with MicroProfile APIs.

Please find the outline of the MicroProfile Tutorial below for your review.
https://docs.google.com/presentation/d/1whbFxay-emqkeMiKdJh2bp6doiVvRfW0oXG_QYRtaTs/edit?usp=sharing
We're particularly interested in feedback on the tutorial's structure, level of detail, and clarity for both beginner and experienced MicroProfile developers.

Please take a moment to go through it and provide any feedback, suggestions, or comments you may have. Your insights will help us tailor the tutorial to better serve MicroProfile communities' needs.

Thanks and Best Regards
Tarun

[John Clingan]

Thanks, Tarun! I wanted to comment on specific lines or paragraphs. How would you like us to do that? Create a pull request? Feels kinda heavyweight.

[Tarun Telang]

Hi John, 

Now, I have enabled Discussions and Issues in my repo. For sharing the feedback, I suggest the following: 

1. You can create a new issue and attach a word document with detailed line by line feedback.

https://github.com/ttelang/microprofile-tutorials/issues

2. For suggestions / ideas or general discussions you can use this

https://github.com/ttelang/microprofile-tutorials/discussions/categories/ideas

3. If you want, I can also generate a word document for the chapter after completion and upload it to the Google Drive workspace for comments.

Best Regards,

Tarun

--
You received this message because you are subscribed to the Google Groups "MicroProfile" group.
To unsubscribe from this group and stop receiving emails from it, send an email to microprofile...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/0892e976-d71d-473b-af83-9ef5ce0d5364n%40googlegroups.com.

[Sergey Beryozkin]

I added a few comments to the MP JWT section

Thanks Sergey

--

[John Clingan]

@Siarhei, how did you comment? I don't see a github issue.

[Sergey Beryozkin]

Hi John

I did it directly in the document, though I'm not sure now it was the right approach - I can resolve those comments and move them to the issue if it gets opened for comments  🙂

Thanks Sergey

To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/f6406275-cc25-4d88-9244-95108949caa1n%40googlegroups.com.

[Tarun Telang]

Thanks Sergey for your comments on the outline.  In my previous email, I was talking about reviewing the content of the tutorial in the github repo.

Regarding feedback on outline, commenting on the document directly is the right approach.

Best Regards, 

Tarun

To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/CAMsYBfWzfGA%2B9LNDsdzE9y_X95v%3Dhaudc2OVDOqmeEotbvZvmw%40mail.gmail.com.