Added page for github tips.

src/docs/asciidoc/documentation.adoc

@@ -17,7 +17,7 @@ TIP: This is an Admonition. You will see many of these scattered throughout the
 
 The link:http://hub.jmonkeyengine.org/[forum] is your first stop when reporting bugs, making contributions, discussing wiki content, or anything else that you can't get the answer for by reading the wiki or searching the forum archives. You will find it to be a friendly and inviting place to have discussions, but before posting, there are two minor rules you will need to observe.
 
-.  For questions that include code, learn link:https://hub.jmonkeyengine.org/t/how-to-type-code-blocks/31155[how to use code blocks]. If you fail to do so, you will at best be reminded of your lapse in judgment and may not receive an answer to your question at all otherwise.
+.  For questions that include code, learn link:https://hub.jmonkeyengine.org/t/how-to-type-code-blocks/31155[how to use code blocks]. If you fail to do so, you will at best be reminded of your lapse in judgment and may not receive an answer to your question at all otherwise. See the <<github_tips#,Github Tips>> page for info on how to insert links into your posts.
 .  link:https://hub.jmonkeyengine.org/t/uploading-pictures-and-changing-avatars-is-disabled/39520[Uploading pictures is disabled] with the exception of a 50k disk space allowance for a forum avatar.
 
 

src/docs/asciidoc/github_tips.adoc

@@ -0,0 +1,75 @@
+= Github Tips
+:author: mitm
+:revnumber:
+:revdate: 2019-09-08T23:24:11.262Z
+:experimental:
+ifdef::env-github,env-browser[:outfilesuffix: .adoc]
+
+
+== Inserting code links into forum posts
+
+There will come a time when you may wish to insert links from github into your forum posts to highlight problems in code, clarify some point your making, or provide more background. Whatever the reasons, here are a few pointers that will help make your posts more robust.
+
+== Creating permanent links
+To create a link to a specific line in a file located on github all you need to do is click the line number inside the file. A three dot tag will appear and the line will be highlighted in yellow.
+
+image::wiki/github_tag.png[github_tag.png,align="left"]
+
+This will append the line number to the URL in your address bar with the format `#L<number>`, in our case `#L61`.
+
+```
+https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java#L61
+```
+
+Click the three dot tag and a option menu will appear.
+
+image::wiki/github_tag_menue.png[github_tag_menue.png,align="left"]
+
+Select the `Copy permalink` option and now you can paste the URL into any forum post or wiki issue and the code display window will show your selection like so:
+
+.jMonkey forum
+image:wiki/github_jme_forum.png[github_jme_forum.png,align="left"]
+
+.Github issue
+image:wiki/github_issue_write.png[github_issue_write.png,align="left"]
+
+image::wiki/github_issue_preview.png[github_issue_preview.png,align="left"]
+
+If you want to select more than one line:
+
+. Select the start line number.
+. Hold down the kbd:[Shift] key.
+. Select the ending line number.
+
+image::wiki/github_multiline.png[github_multiline.png,align="left"]
+
+All the lines between will be highlighted as well. This will change the URL using the format `#L<number>-L<number>`, in our case `#L83-L86`.
+
+```
+https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java#L83-L86
+```
+
+The above mentioned links are just normal URLs. This means that this line will be linked forever at this point in this file as long as it exists. What if the line changes or what you were referring to goes away or moves to another line? Canonical URLs to the rescue!
+
+== Canonical URLs
+
+A Canonical URL will attach the SHA hash number of the commit to the URL so even if the file changes, that link will always point to the same file and same line.
+
+.Normal URL
+```
+https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java#L83-L86
+```
+.Canonical URL
+```
+https://github.com/jMonkeyEngine/jmonkeyengine/blob/a9afcecc41b54feaac253e38d2f2282c8c6027fc/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java#L83-L86
+```
+
+Notice the hash commit number is now part of the URL.
+
+To make the Canonical URL just select the kbd:[y] hot key after selecting the line number or numbers. Once you have done this, all links from thereafter will be Canonical URLs.
+
+'''
+Suggested reading:
+
+* link:https://help.github.com/en/articles/keyboard-shortcuts#source-code-editing[Source code browsing]
+* link:https://help.github.com/en/articles/getting-permanent-links-to-files[Getting permanent links to files]