KoBeWi / Metroidvania-System

General-purpose framework for creating metroidvania games in Godot.
https://godotengine.org/asset-library/asset/2301
MIT License
1.04k stars 49 forks source link

Any docs page planned? #28

Closed Visnicio closed 6 months ago

Visnicio commented 7 months ago

I feel that this add-on has a lot of potential, but it lacks a good and more non-linear docs than just the README.

If you guys do not have anyone working on the documentation, I would be pleased to be the first one to take that seat :)

KoBeWi commented 7 months ago

The README has headers, so you can use table of contents to navigate. I remember someone on Reddit mentioned a wiki (it's a GitHub feature). Maybe I'll look into that.

Visnicio commented 7 months ago

IMO the README has made a good job of explaining concepts from the addon, but since the addons has a lot of features probably we would need a reserved docs page to explain about the available classes and methods, this way the user can create a minimal setup better for his case

KoBeWi commented 7 months ago

The documentation is available in Godot itself. It's generated from the GDScript files using the built-in documentation system.

KoBeWi commented 6 months ago

I'm in the process of moving the README to wiki: https://github.com/KoBeWi/Metroidvania-System/wiki Once I finish, I will remove the duplicate content from README and close this issue. You can give some feedback in the meantime (and afterwards).

Visnicio commented 6 months ago

The docs seems pretty fine so far, congrats!

What I would add is a API reference with simples methods explanation, nohing fancy, just pure function calls and explanations, i.e:

MetSys class

var metsys : MetSys = MetSys.new() # Instantiates/Initialize a new MetSys

MetSys.get_current_room_instance() # Returns the current map scene
Visnicio commented 6 months ago

I was thinking of forking the repo and creating a fanmade docs, and if you like it, maybe you can incorporate on the current docs

KoBeWi commented 6 months ago

Well as I said before, the documentation is already available inside the editor: image It's briefly mentioned in the README, but maybe I should make it more prominent and list available classes. I don't know any tool that would turn GDScript documentation into something you can put on GitHub, and I'm not doing it manually, so the class docs won't be available on the wiki.

Visnicio commented 6 months ago

fair enough, maybe I'm just dumb, couldn't find the docs inside Godot

KoBeWi commented 6 months ago

Press F1 and search for MetroidvaniaSystem class.

KoBeWi commented 6 months ago

The wiki is finished and the documentation is mentioned here: https://github.com/KoBeWi/Metroidvania-System/wiki/General-Information#code-documentation