RE-UE4SS icon indicating copy to clipboard operation
RE-UE4SS copied to clipboard

Fix readme file not populating on the correct docs versions

Open Buckminsterfullerene02 opened this issue 1 year ago • 3 comments

Description

Currently, ue4ss home page and release tag (i.e. v3.0.1) shows the instructions for building ue4ss against main branch, which is incorrect, and has lead to a lot of confusion where people are trying to build C++ mods against main branch, while having stable version of ue4ss installed, which don't work. This is especially bad current as the build system is different between v3.0.1 and dev version.

Adds proper caution tags to the top of the readme depending on the version being viewed

Also edit readmes for non-dev versions that reflects the correct way to clone the repository

How Has This Been Tested?

  1. Run following commands in order: cargo binstall --no-confirm mdbook-mermaid mdbook-mermaid install docs-export/ cargo binstall --no-confirm mdbook-alerts python docs-export/export.py python docs-repo/build.py
  2. Open docs-repo/docs/ and then open index.html and view readme

Release readme changes: image image

Dev readme: image No change to the build instructions

Any release tag version (e.g. v3.0.0): image image

Buckminsterfullerene02 avatar Dec 07 '24 21:12 Buckminsterfullerene02

Currently, ue4ss home page and release tag (i.e. v3.0.1) shows the instructions for building ue4ss against main branch, which is incorrect

Maybe it's not the right place to discuss, but in my opinion people should use and make mods for the experimental version. In experimental version a lot of bugs were fixed + all new game releases which use 5.3 and up require it anyway. I would even like to suggest to release a new stable version ASAP or make the experimental version easier to find. The stable version doesn't even work for some games like Hogwarts Legacy (4.27) anymore. I can't remember the reason but the "stable" version is simply old and a lot happened on all ends (Pseudo, patternsleuth etc.) Also as mod developer I find xmake easier to use and I'm glad that I don't have to install and deal with cmake. It might change back to cmake later, but currently xmake is alright as long there are no problems.

igromanru avatar Dec 07 '24 21:12 igromanru

Currently, ue4ss home page and release tag (i.e. v3.0.1) shows the instructions for building ue4ss against main branch, which is incorrect

Maybe it's not the right place to discuss, but in my opinion people should use and make mods for the experimental version. In experimental version a lot of bugs were fixed + all new game releases which use 5.3 and up require it anyway. I would even like to suggest to release a new stable version ASAP or make the experimental version easier to find. The stable version doesn't even work for some games like Hogwarts Legacy (4.27) anymore. I can't remember the reason but the "stable" version is simply old and a lot happened on all ends (Pseudo, patternsleuth etc.) Also as mod developer I find xmake easier to use and I'm glad that I don't have to install and deal with cmake. It might change back to cmake later, but currently xmake is alright as long there are no problems.

You are very correct, and I think that perhaps this PR should only be merged after the next major release. Because this is still a bug with the docs site, but I think that for now having the "wrong" readme at the front is fine.

Just to clarify, we usually don't want to have the developer docs readme in the stable docs area, because the C++ mod ABI breaks frequently within the experimental version, which makes it a very, very bad idea to have C++ mods developed on, as they will break frequently.

Buckminsterfullerene02 avatar Dec 07 '24 21:12 Buckminsterfullerene02

Converting to draft to get it out of the way until it's ready to be merged.

UE4SS avatar Mar 29 '25 10:03 UE4SS