Add more stuff about debugging

[liach]

No description provided.

[ST-DDT]

This is a good start on how to prepare for debugging, but it does not yet cover the actual debugging process.

Things I would like to see are:

• Debugging options such as the post mixin class content output (I forgot the command line option for that)
  • Tools for decompiling the post mixing code (jd-gui or similar ones)
• How to debug (at least some few lines , a link to tutorials for common IDEs or a link to a debug section for plugins)
  • Suggest the creation of a test plugin along with the contribution/PR.
• Common issues you might encounter (Broken mixin, NPEs, PhaseErrors with suggestions how to fix them or a link to their respective documentation)
• Help with finding the error in your mixin based on the stacktrace (The only help you get is the line number)

[ST-DDT]

Addresses: #356 (Fill "Debugging Sponge from IDE" page)

[ST-DDT]

@liach Any updates on this?

[liach]

Unfortunately nope. I am currently in china and cannot even log into discord (it asks me to check email while i cannot log on to my email service in china)

[Inscrutable]

This is gathering dust @liach - will you be able to complete it soon?

[liach]

Unfortunately no. I cannot find big chunks of time to devote on stuff.

[ST-DDT]

@liach Is the current part complete enough to be merged - so that we have at least this instead of nothing?
We can always PR the remaining stuff later.

[liach]

i'd get a developer to confirm the validity of this portion.

[Inscrutable]

I wonder if ReST will interpret this as three lists and start each one at 1.. We shall see...

[liach]

I recall @Spongy builds prs automatically. Doesn't it?

[liach]

Hmm. appears spongy doesn't like me (no branch 661)

[phit]

that seems like a rather complicated way of doing this all, why would you have a SC branch without already having a SF or SV workspace?

what I think most here do, setup SF or SV as usual, then cd into the SpongeCommon folder and create a new branch.. really I don't see the point of anything you added here

this page if anything should simply have the sf/sv setup instructions that are also in the main repo readmes followed by what is already covered in the plugin debugging page https://docs.spongepowered.org/stable/en/plugin/debugging.html#running-the-configuration

[Spongy]

A preview for this pull request is available at https://cdn.rawgit.com/Spongy/SpongeDocs-PRs/2a7e549/.

Here are some links to the pages that were modified:

• modified: https://cdn.rawgit.com/Spongy/SpongeDocs-PRs/2a7e549/contributing/implementation/debugging.html

Since the preview frequently changes, please link to this comment, not to the direct url to the preview.

[liach]

Closing in favor of #784 as suggested by inscrutable