New Session About Hans-on F#

kirisky commented 1 month ago

Session on Hans-on F

Dong, from Individual Contributor. In EET/EEST, would like to tackle: Onboarding to F# world and hands-on experience

Extra

This will be a project-based demonstration aimed at showcasing the F# ecosystem and best practices by building a real-world application.

This project-based demonstration will showcase the F# ecosystem and best practices by building a real-world application. The goal is to help newcomers become familiar with the F# ecosystem and best practices.

Dependency

This will happen after Session About Solving Good First Issues for FSharp

nojaf commented 4 weeks ago

Thanks for creating this! I think there are two key aspects to consider:

How would you create a larger scale application? This includes organizing code, setting up tests, linting, documentation generation, and more.
How do I navigate the .NET and F# ecosystem? This could be interesting to explore, as I often find it to be a source of frustration.

Which aspect would you be most eager to explore?

kirisky commented 4 weeks ago

Hi @nojaf! Thank you so much for the feedback! It is really helpful for refining the session plan.

I'd like to cover both, but doing it all in one session might make it too long to follow. So, I am thinking of breaking it up into several shorter sessions.

How would you create a larger scale application? This includes organizing code, setting up tests, linting, documentation generation, and more.

I completely agree with you. The project will be small to small-medium in scale. Ideally, I’d like to cover all the topics you mentioned as part of this project.

My current plan is to create something straightforward, like a simple web crawler or a CMS/CRM. These types of projects are easier to keep within a manageable scope, widely understood in the real world, and provide a great way to showcase F#'s ecosystem. That'll be able to demonstrate commonly used libraries and components, such as API services, databases, caching JSON handling, parallel processing, and data display.

I am planing to structure the sessions as followings:

1st session
- Set up the project and integrate the necessary libraries. By the end, we will have a working example, like crawling Wikipedia pages and displaying the data
2nd session
- Refactor the project, applying best practices for code quality and maintainability
3rd session
- Show how to deploy the project to Azure using F#-related tools (FARMER, AzureCLI, or others)

If you have any suggestions on topics or how to organize the sessions, please feel free to share your thoughts as it would be extremely helpful in planning the sessions. I would greatly appreciate any ideas or suggestions from you or the community to help shape these sessions.

How do I navigate the .NET and F# ecosystem? This could be interesting to explore, as I often find it to be a source of frustration.

Could you provide more details on this, Flo? What scenarios cause frustration in your case?

nojaf commented 4 weeks ago

Thanks for the enthusiasm, @kirisky! My initial reaction is that three sessions might be quite demanding for you to start. You may want to focus on the first session without overpromising the audience that this is a trilogy. It might be helpful to outline what you aim to cover in the first session so we can discuss the various aspects in more detail.

Another suggestion is to reach out to the maintainers of the different tools you'll be using to learn how they recommend utilizing them in 2024. For instance, if you use Fable, consider messaging Maxim to inquire about the recommended or active packages in Fable these days.

It could also be beneficial to start from a template (SAFE, SAFEr, mini scaffold) and adjust as needed.

Could you provide more details on this, Florian? What scenarios cause frustration in your case?

I'm currently working with OCaml. Learning the language isn't really the hard part for someone coming from F#, but I find it challenging to grasp the build system, package management, switches, and which unit test framework to use. This is similar for anyone transitioning from another ecosystem to F#. The .NET CLI, fsproj files, NuGet—all these elements have a learning curve.

kirisky commented 4 weeks ago

Thank you so much, @nojaf! I'll adjust the content capacity based on the information and suggestions you shared.

dawedawe commented 2 weeks ago

Hey @kirisky , are you still interested in having a session? Maybe Nov 22nd or early December?

kirisky commented 2 weeks ago

Hey @kirisky , are you still interested in having a session? Maybe Nov 22nd or early December?

Hi Dawe! Yeah, I am still. But I have not been ready. If it is needed, I can prioritize this one as my first session.

I would prefer to do the session in the early of December as this month is not available for me to prepare this.

What do you say?😃

dawedawe commented 2 weeks ago

Sounds great. Thanks! How about December 6th?

kirisky commented 1 week ago

Yeah, it works for me.

If there’s anything I should be aware of for this session, please let me know in advance!

Thank you, @dawedawe! 😄

dawedawe commented 1 week ago

Awesome, we'll prepare a session page PR for you to review containing some description of the session. Similar to the ones here: https://amplifyingfsharp.io/sessions/ Then we should have a short test zoom call in the days before the session to make sure the streaming setup works from your machine.

kirisky commented 1 week ago

Thanks, Dawe!

Will take a look other sessions as well for preparing mine. If you have any other recommended resource, just let me know. :)

amplifying-fsharp / sessions