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

Documentation Updates #254

Open
Tracked by #340 ...
Qubus0 opened this issue Jun 3, 2023 · 4 comments
Open
Tracked by #340 ...

Documentation Updates #254

Qubus0 opened this issue Jun 3, 2023 · 4 comments
Assignees
Labels
documentation Improvements or additions to documentation
Milestone

Comments

@Qubus0
Copy link
Collaborator

Qubus0 commented Jun 3, 2023

Topic Status Documentation
ModLoader API ✔️
- Add Methods Overview table to ModLoaderUserProfile ✔️ ➡️
ModLoaderMod ✔️ ➡️
- Update API Method description ✔️ ➡️
- Update moved methods from ModLoaderMod to ModLoaderModManager ✔️ ➡️
ModConfigs ✔️ ➡️
- Writing configs ✔️ ➡️
- Defining configs via json schema ✔️ ➡️
- Supported types (can this be found in the schema docs? if not, maybe it should be there instead) ✔️ ➡️
- New API methods ✔️ ➡️
- Example config editor repo ✔️ ➡️
ModUserProfiles
- Explain profiles
- What does the user set
- What does the dev set
ModLoader Options ✔️ ➡️
- Explain available option ✔️ ➡️
- Explain profiles ✔️ ➡️
- Explain Feature Flag overrides ✔️ ➡️
Guides
- Guide on publishing a mod
- Guide on how to enable steam workshop support
- Create a guide on how to create mod configs ✔️ ➡️
Examples
- Update the example Mod ➡️
Godot Project Setup ✔️ ➡️
- Explain JSON_Schema_Validator ✔️
- ModLoaderStore Autoload ✔️
Mod Structure ➡️
- Add a tip to use the Dev Tool to package the mod zip ➡️
Mod Files ✔️ ➡️
- Update the manifest example ✔️ ➡️
- Remove ModLoader argument from _init() function examples Edit: This requires code changes as well. - Done in #324 ✔️ ➡️
Steam Workshop Support
- Enable steam workshop (including adding the steamdata json)
- Why use a json for the app_id if it can just be put into the code
Deprecation System ➡️
- What is it, what do you have to do, how to turn it off
Logging ➡️
- Update log file paths ➡️
- Mention the log file rotation #100
- Remove the Methods section - link to the ModLoaderLog API Section instead ➡️
- Add a section on how to set the verbosity via options.tres ➡️
Upcoming Features ➡️
- Saving is currently an internal api ➡️
- Mod Config Docs are up, remove the section here ➡️
- Clean the page after everything is documented ➡️
Mod Loader Options ➡️
- Add Mod Source and add deprecation note to steam_workshop_enabled #369
@Qubus0 Qubus0 added the documentation Improvements or additions to documentation label Jun 3, 2023
@KANAjetzt KANAjetzt added this to the v6.0.0 milestone Jun 8, 2023
@KANAjetzt KANAjetzt self-assigned this Jun 8, 2023
@KANAjetzt KANAjetzt changed the title New config system documentation Documentation for v6.0.0 Jun 14, 2023
@KANAjetzt
Copy link
Member

KANAjetzt commented Jun 14, 2023

The plan is to generate the Class Reference using gdscript-docs-maker.
However, we are currently facing an issue where the extended Class links point to ..\something, which results in 404 links on the Wiki page. While it's possible to update the generation process to link to the Godot docs instead, changing the package is not an ideal solution.

@KANAjetzt KANAjetzt mentioned this issue Jun 14, 2023
15 tasks
@ithinkandicode ithinkandicode self-assigned this Jun 14, 2023
@KANAjetzt KANAjetzt pinned this issue Jun 15, 2023
@KANAjetzt
Copy link
Member

I added a new page so we don't lose the additional info about script inheritance and inheritance chaining.
I also added a section for virtual functions in script extensions there.
https://github.com/GodotModding/godot-mod-loader/wiki/Script-Extensions

@KANAjetzt KANAjetzt changed the title Documentation for v6.0.0 Documentation Updates Mar 22, 2024
@ZackeryRSmith
Copy link
Contributor

The plan is to generate the Class Reference using gdscript-docs-maker. However, we are currently facing an issue where the extended Class links point to ..\something, which results in 404 links on the Wiki page. While it's possible to update the generation process to link to the Godot docs instead, changing the package is not an ideal solution.

This is a good idea and something I would personally love to use in GMLWiki for the API documentation. The only concern I have is gdscript-docs-maker only works in 3.x not 4.x as mentioned in the repository. Any solutions?

@Qubus0
Copy link
Collaborator Author

Qubus0 commented Jun 5, 2024

I guess we will have to use --gdscript-docs and convert the xml to markdown

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

No branches or pull requests

4 participants