Merge pull request #2866 from mohamed-ismail99/main

Added a troubleshooting section for hugo

Author: jasonrandrews

content/learning-paths/cross-platform/_example-learning-path/appendix-5-troubleshooting.md

@@ -0,0 +1,29 @@
+---
+# User change
+title: "Troubleshooting"
+
+weight: 12 # 1 is first, 2 is second, etc.
+
+# Do not modify these elements
+layout: "learningpathall"
+---
+## Hugo Server Issues
+
+### Hugo server is not staging or detecting my content updates when I publish the server, How to fix it?
+
+There could be multiple reasons for the Hugo server not detecting your content updates. Please try the following steps in order:
+
+* Check that you are pusblishing the server from the right directorty where you are updating your learning path (You might have multiple locations where you are updating and saving your content to and you could be starting the server from the wrong location/directory).
+
+* Your Browser might be caching the older version of your server/pages. Please clear your browser history or turn off cashing or simple open a new private tab/window and call your page from there.
+
+* Draft mode is activated: sometimes when we return back your learning path after we review it for adjustments, we usually enable "Draft Mode" which will not stage any new content to be published. Once you pull back the learning path changes "Draft Mode" will be activated by default. To fix this issue you can try one of the following options:
+1. Remove the "Draft Mode" tags. Ususally, you will find "draft: true" tag(s) on the main/first page of your learning path (it could also be in other pages). Simply comment out those tags or remove them till you are done with your updates and rerun the Hugo server again.
+2. Rerun the server using the following options: 
+```bash
+hugo server --buildDrafts=false
+``` 
+or
+```bash
+hugo server -D
+```

content/learning-paths/cross-platform/_example-learning-path/setup.md

@@ -182,6 +182,12 @@ Open a browser and go to [http://localhost:1313](http://localhost:1313)
 
 You are now ready to edit markdown files and view the results on the Hugo server. 
 
+{{% notice Note %}}
+
+If your content is not updating/staging on your web browser after you save it correctly then please check the [Troubleshooting section](/learning-paths/cross-platform/_example-learning-path/appendix-5-troubleshooting/) for debugging instructions.
+
+{{%/notice%}}
+
 ## Enable the search box on the home page {#search}
 
 When you run `hugo server` you will not see the search box on the home page. You don't need to do anything for the search feature to find your content, but you may want to enable the search box and test it during your development.