FanTranslatorsInternational / Kuriimu2

Kuriimu is a general purpose game translation project manager and toolkit for authors of fan translations and game mods.
GNU General Public License v3.0
308 stars 56 forks source link

Install steps not clear in README #312

Closed Fusseldieb closed 6 months ago

Fusseldieb commented 7 months ago

I've downloaded countless of runtimes, both x86 and x64, and even restarted, to no avail.

The install steps are unclear and the dialog doesn't do anything if "Yes" is clicked:

Putting links to the correct runtimes in the README would be immensely helpful.

Fusseldieb commented 7 months ago

After a LOT of trial and errors, what ended up working was installing exactly this: .NET Core 3.1 Desktop Runtime

Link below:

https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-3.1.32-windows-x64-installer

Drflash55 commented 6 months ago

Fusseldieb said: After a LOT of trial and errors, what ended up working was installing exactly this: .NET Core 3.1 Desktop Runtime

This also worked for me. This DEFINITELY should've been more specific about what you needed to actually run it.

onepiecefreak3 commented 6 months ago

The READ.ME clearly states: "You need to have the .Net Core Desktop Runtime 3.1.6 installed on your system." You instead installed the .Net Core Desktop Runtime 3.1.32 now, to which you linked.

I'm unsure how it can be made even more clear? Since the name matches exactly what you were supposed to do. And since the download page of Microsoft changes for that runtime quite often, we won't put a link there.

I'd like a clearer suggestion as to what could be changed, as I don't really see it.

Fusseldieb commented 6 months ago

I'd like a clearer suggestion as to what could be changed, as I don't really see it.

As I said in my original post, I downloaded heaps of different versions. They all have ".Net" in it. Not being a .Net developer, this confused me as heck. I literally almost gave up.

My suggestion would be to hyperlink the name in the README, so it redirects to the RIGHT download page.

onepiecefreak3 commented 6 months ago

But the name is very clearly written in there, as I quoted in my reply. It's ".Net Core Desktop Runtime". And as I said, the link structure of the microsoft pages regularly change, so a hyperlink is not maintainable.

If this isn't enough, I'm not sure what more I can do.

Fusseldieb commented 6 months ago

But the name is very clearly written in there, as I quoted in my reply. It's ".Net Core Desktop Runtime". And as I said, the link structure of the microsoft pages regularly change, so a hyperlink is not maintainable.

If this isn't enough, I'm not sure what more I can do.

The real issue is that if I go onto the "Net Core" download page, I get plastered with links and downloads, none of which explicitly tell you "on, this one is the right one".

image

A inexperienced user will definitively not know what to choose.

onepiecefreak3 commented 6 months ago

The READ.ME clearly tells you to download ".Net Core Desktop Runtime" and you clearly have a section there titled exactly that. And since the READ.ME also specifies that x64 is required you can only click one link.

I'm still struggling to see the issue. Even if there are many links, you only need that name to figure out on which link to click.

Fusseldieb commented 6 months ago

he READ.ME clearly tells you to download ".Net Core Desktop Runtime" and you clearly have a section there titled exactly that.

Nope, there's a section called ".Net Desktop Runtime 3.1" and then there's "ASP.Net Core Runtime 3.1". I thought the one with "Core" in it was the right one. It wasn't.

onepiecefreak3 commented 6 months ago

While I'm not sure how "ASP.NET Core Runtime" is somehow more logical than ".NET Desktop Runtime", even though more words match (if not exactly match, I'll give you that one), I will remove "Core" from the READ.ME in the installation instructions.

Otherwise I will close this issue now. Without offending you or the other user that responded, I asked around some of the less knowledgable people on our discord, and they didn't struggle as much or at all. So, I will make the change I mentioned and will not waste anymore time on this.

Thanks for the feedback anyway. Hopefully this small change helps someone else out.

Fusseldieb commented 6 months ago

Now it's clearer! Thank you.