-
Notifications
You must be signed in to change notification settings - Fork 72
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
Overhaul Readme #552
Overhaul Readme #552
Conversation
Reformatted the readme to restructure various pieces of information and also add some extra information about SteamTinkerLaunch's functionality
Wow I think you should be the official PR guy for steamtinkerlaunch lol your wiki and now readme contributions look amazing nice 👍 Hopefully @frostworx has time when he pops back over here (no rush) to look at this and merge it (technically I think I have permissions to merge this but I want to wait on him) my first thought when I was reading your wiki is why not list more features but NVM that would get unwieldy and possible overwhelm the user (not to mention more work 🤣) |
Thank you for the kind words 😄 I do my best to help out with and promote STL where I can :-) Before merging though I was reading through my writeup again and there are a couple of changes I'd like to make:
Should hopefully have those fixed in the very near future 😄 |
Hmm, I noticed the repositories widget doesn't list the Fedora package (quite out of date but still worth mentioning, could bring attention to it to ask for an update) or the Nobara package (less than a day old at the time of writing, but if the Fedora package isn't found by the widget I don't think the Nobara one will be either). They are both hosted on Fedora Copr which seems like a Fedora AUR of sorts? The repository had to be added separately but there is also a Pacstall package which the widget lists, and it has to be installed separately. Ideally we'd like to advertise all the available packages but that's probably more up to whoever maintains that package widget. We could always add a section on the Readme saying more packages may be available, and add Fedora and Nobara under the Distro-Specific section of the Installation instructions. |
Dug a little deeper and it seems Repology doesn't support these packages, which is unfortunate (repology/repology-updater#745). I suppose a solution going forward would be to amend the package management section of the wiki to include instructions for each package? Either way it seems like it could be kept out of the Readme, and the Readme also has a section where there may be other packages out in the wild, which should imply to users that the list of packages may not be exhaustive. |
…ut adding SteamTinkerLaunch to the path
Alright, I've made a few changes:
This PR got a bit messy with the commits as I was just using GitHub's markdown editor to make the changes, but merging with squashing the commits should be fine as this is only the Readme. We don't need like 8 commits that are just amending some Markdown 😄 |
I blindly trust you, because any wiki change of you makes it better without nay doubt, @sonic2kk. |
I've felt for a while that the Readme for SteamTinkerLaunch could do with a bit of an overhaul, namely in the following ways:
You can check out the new Readme visually on my fork which is probably better for review purposes.
This overhauled Readme mainly just organises existing information that was already on the Readme. I added a table with a list of what I thought were key features of SteamTinkerLaunch that aren't simply third party dependencies - So excluding things like GameScope and MangoHud which are separate programs that STL just configures. I'm very open to feedback on this list, but I asked myself the question, "What features would I tell Windows users migrating to Linux about?" The answers I came to were: Mods, SpecialK, ReShade and easy downloading of Custom Proton/Wine releases.
In fact, the whole mentality I took while writing the Readme was how best to advertise SteamTinkerLaunch to new users. If there was someone who just happened to stumble across STL, what would they want to see and know? What is the best way to "sell" SteamTinkerLaunch? I have friends who are waiting on Steam Decks and I know someone planning to switch to Linux in the near-future on a new PC, so in part these changes were inspired so that I could just send them the project link and they can see all of the information themselves.
I feel like the new design of the Readme helps a lot with showing the project off, while also linking out to additional resources on the wiki and upstream projects. If someone hadn't heard of ModOrganizer 2 for example, there is a link to the upstream project. I wanted to ensure the Readme to be clear, informative and still easy to follow.
I realise this is a very huge change, and not all of the changes here might be welcome. Don't be afraid to be nitpicky, and if the changes are totally undesired I can close this PR.
Thanks! 😄