The Getting Started document could be updated for .NET 8

[MatheusXavier]

Doc Update Suggestion

A little while ago I migrated my project to dotnet 8 and I noticed that the Getting Started documentation is a little outdated, for example:

• A namespace is being declared in the Program class
• The Program class is being declared
• The Program class is implementing the Main method
• Not using WebApplication.CreateBuilder

Not that these points are serious problems, but I believe that the documentation could be updated.

During the migration I I implemented my Main class a little differently and published this article on medium to demonstrate my approach.

I am willing to make a PR if you fine folks think this kind of changes is welcome.

[raman-m]

Hi Matheus!
Welcome to Ocelot world! 🐯

Nice article! Thanks you!
Have you posted this article to LinkedIn network?

---

Not that these points are serious problems, but I believe that the documentation could be updated.

Not serious! It could be, because we support .NET 6+ only since November'23.

Have you ever thought in terms of backward compatibility?
This old, legacy Program.Main startup approach is supported by .NET 6+ SDKs also...
But Yes, because .NET 6+ app can have implicit entry point aka Top-level statements so it makes sense to upgrade the docs and samples apps.

If you have intention to contribute, I would ask you update all samples apps too... 🆗 ❔

[MatheusXavier]

Hello Raman!

Thank you!

---

Have you posted this article to LinkedIn network?

No, I have not, only on medium.

---

Have you ever thought in terms of backward compatibility?

Thinking about backwards compatibility, I don't think it will be a problem because we don't need to apply everything in the article and almost everything in it works in dotnet 6.

---

If you have intention to contribute, I would ask you update all samples apps too... 🆗 ❔

Ok, I'll update the samples apps and the getting started doc.

Can you create a new branch for me so I can work on it?

[ggnaegi]

@MatheusXavier you should fork the repo, then create your own branch in the forked repo. When you are ready, you can from there create a PR.

[raman-m]

@MatheusXavier As @ggnaegi said, you have to fork Ocelot repo and create feature branch in your forked repo.
More about our development process: Release Process

When you'll create a PR this feature ticket will be accepted.
But you can go to develop right now because you are assigned. 😉
Pay attention that Samples require to setup Docker Desktop and run Docker locally. All projects have Dockerfile.
Unfortunately, we have not added each Sample solution to Docker Compose project to have local Docker network when debugging and running.
Have you ever worked with Docker and Docker Compose?

Good luck having much inspiration!

[raman-m]

Three months have passed!..
@MatheusXavier, where are you?
You need to update your develop branch to be identical to head repo one! Now it has the diff. The diff must be zero, no changes at all.

Also I see the feature branch: 1912-update-docs-and-apps-samples
But it has no much changes, very initial development.
Why did you stop development on Jan 13?
What's your plan of delivery?

FYI

The samples folder was changed much in PR #2045 .
So, you have to rebase your feature branch! Or, create new branch from develop.

[raman-m]

@MatheusXavier Hello Matheus!
How have you been in 2024? Have you written articles on Medium blogs related to Ocelot? 😉 I have an idea to publish them in Discussions Show and Tell articles, as we currently do not have a dedicated Ocelot blog.

Thinking about backwards compatibility, I don't think it will be a problem because we don't need to apply everything in the article and almost everything in it works in dotnet 6.

Please note that we have discontinued support for .NET 6 and 7 and we are now migrating Ocelot to .NET 9, with .NET 8 as the major LTS version. Consequently, your issue opened on January 9 has become highly relevant. It appears we need to address the ticket and move it into active progress. Are you still with Ocelot and able to assist us?

[raman-m]

@MatheusXavier commented on Jan 9, 2024

I am willing to make a PR if you fine folks think this kind of changes is welcome.

An entire year has passed 🤔 What is a PR number? 🙉

[MatheusXavier]

Hi @raman-m

Unfortunately I didn't have time to implement that, I also switch between job and now I'm not working with Ocelot anymore, thank you for all support but I'm going to close this issue.

[raman-m]

Updating samples/docs is required!