decryptedchaos changed the title to Documentation Issues .
Documentation Issues
- Level 450 Commodore
- Edited
Zeftax Btw. is there a way to submit patches without a github account or am I stuck with just posting it here?
Pretty much limited to posting it here without a GitHub account the docs run from GitHub it automatically compiles and converts them into a static site.
Still, the leg work is useful, someone will surely pick it up and go make the patch if you don't
Also you should be able to edit your OP by clicking the 3 dots when you hover over it.
- Level 125 Enlisted
decryptedchaos That way I can only change the contents, not the name. Which is probably for the better, since the address gets changed with renaming as well :-D.
I did edit it to reflect that not only renaming issues belong here, and also spoilered the initial list of issues as I felt it took up too much space.
- Level 125 Enlisted
More documentation issues below:
3D > Tools > Using GridMaps
The gridmap_starter.zip file is missing.
3D > Tools > Third-person camera with spring arm
The link to the asset library is broken.
3D > Tools > Third-person camera with spring arm
The spring_arm_camera.webm file is missing.
Assets pipeline > Importing audio samples
I don't really understand audio, but is the peak really meant to be 0dB? I think it may be a typo and 1dB is what the author meant to write. I am almost sure it's not 0, but I have no idea to what number it actually normalizes the peak.
Assets pipeline > Importing translations
While it has a link to locale codes, which are a child of Internationalization, it would probably be nice to have a direct link to Internationalization (maybe at the end?), because people will be likely interested in learning more about the topic if they are reading this article.
Internationalization > Internationalizing games
The link to the demo is broken.
Assets pipeline > Importing 3D scenes < Available 3D formats
The link to the "FBX import page of the Redot website" is broken, and weirdly named.
Assets pipeline > Importing 3D scenes > Import configuration
The Normal Split Angle and Normal Merge Angle have the same description, maybe highlight what the difference between those two options is?
Assets pipeline > Retargeting 3D Skeletons
The link to the godot 4.0 animation data rework article is broken.
- Level 50 Warrior
Zeftax Would you be interested in working on the Redot docs?
- Level 125 Enlisted
TakunHiwatari I am just reading through them and pointing out mistakes I see, but if there is a way I could submit patches without my soul being stolen by Microsoft then sure, I'd love to help.
- Level 50 Warrior
Zeftax Probably not since the dev stuff happens on Github.
Just keep using this thread and I'll kick it over to the docs team.
- Level 125 Enlisted
Hopefully the last biggish dump, I've made my way through the parts of the manual that interested me and now I wanna mak gam!
Manual > Assets pipeline > Blender ESCN exporter
The link to the redot blender exporter is broken
Manual > File and data I/O > File paths in Redot projects
The link to the redot flatpak package links to a godot flatpak package.
The link to the steam release of redot links to the godot steam page.
Manual > Plugins > Installing plugins
The link to the asset library is broken
Manual > Plugins > Making plugins
The link to the asset library is broken
Manual > Shaders > Shading reference > Spatial shaders
The link to the alpha_to_coverage-explaining pull request is broken.
Manual > Shaders > Shaders style guide
The link to redot source code is broken.
a month later
- Level 125 Enlisted
- Edited
The "Online docs" button in the inbuilt text editor takes me to https://docs.redotengine.org/en/stable/en/4.3/, that page claims to not have been found. I've checked and the godot equivalent has not been found either (although I don't know whether the godot text editor links to that same page).
Edit: I should add that I am on 4.3.stable
- Level 450 Commodore
Zeftax The "Online docs" button in the inbuilt text editor takes me to https://docs.redotengine.org/en/stable/en/4.3/, that page claims to not have been found
This is somewhat of a known issue, we are working on a solution, the doc system isn't the best setup in its current form.. IIRC there are a lot of makeshift solutions to convert them over..
The docs really need to be fixed better than they are.. but it takes time.
- Level 450 Commodore
Zeftax even the one that is "redot" in the docs is not "redot" in the github repo. Have the changes only been made locally on the machine that serves the docs?
That's what i mean, the original person that converted it didn't actually convert it has a GitHub action on it that find & replaces all the references to Godot every time it builds the docs which happens automatically every Sunday.
I think they thought by doing so it would eliminate merge issues if/when we were to sync docs with Godot, but its been causing some trouble. Beyond that, the docs (Spinx) requires a separate branch of the docs be maintained for every version of the engine, and IIRC we currently do NOT have a dedicated maintainer for docs, the person that was doing it got burnt out i think..
10 days later
- Level 450 Commodore
Zeftax Ahh yeah, it's because Godot uses Matrix for core dev chat. IIRC