Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

NuGet requirements are unclear in the tutorial #7509

Open
perlun opened this issue Feb 19, 2025 · 1 comment
Open

NuGet requirements are unclear in the tutorial #7509

perlun opened this issue Feb 19, 2025 · 1 comment

Comments

@perlun
Copy link

perlun commented Feb 19, 2025

Please describe what you are trying to understand
I want to know what NuGet packages are required to get the first tutorial listed on the web page working

Which pages have you looked at?
https://getakka.net/articles/intro/getting-started/tutorial-1.html

What did these pages not make clear?
This tutorial includes code like this:

var firstRef = Sys.ActorOf(Props.Create<PrintMyActorRefActor>(), "first-actor");
Console.WriteLine($"First: {firstRef}");
firstRef.Tell("printit", ActorRefs.NoSender);

But in what NuGet package/namespace is the Sys class located? I tried with both Akka and Akka.Hosting (I think), but my editor doesn't seem to find this class anywhere despite adding these dependencies.

I then installed the Akka.NET templates and created a sample console application like this:

$ dotnet new install "Akka.Templates::*"
$ dotnet new akka.console -n akka-console-test

...but the code generated from this template is very different in that it uses the Microsoft.Extensions.Hosting.HostBuilder.

How can we do it better?
I would suggest to make the tutorial mention those steps ("add the NuGet package(s) foo and bar"). It may be obvious to experienced Akka.NET users but I think it would be helpful to newcomers. Also, even including the using statements could be an idea (even though it'll make the examples more verbose).

Additional suggestions

@Aaronontheweb
Copy link
Member

I think we're just going to delete that tutorial outright and refer users to https://petabridge.com/bootcamp/lessons instead - which I just finished last week and is 100% up to date.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants