Differences

This shows you the differences between two versions of the page.

--- howtouse [2025/05/20 07:55] – wikiadmin
+++ howtouse [2025/08/20 06:52] (current) – wikiadmin
@@ Line 1: / Line 1: @@
 ======How should FSGW use this wiki?======
-  * Do not write longer documents in wiki markup - It's not meant for that.
+=====Strategy=====
-    * Use a proper word processor and post a PDF here
+  - The important purpose of this wiki is to preserve and make it easy to find FSGW information, documents and other resources. I have seen too many cases where information was lost when people left, or people forget things over time.\\ \\
-    * [[wiki:publish_from_google|How to Publish a Google Doc or Sheet for web viewing]]
+  - The information itself will not all be stored inside the wiki, but links and descriptions for as much information as possible should be in the wiki.\\ \\
-  * Use wiki markup to create the Index pages, and short information pages
+  - A huge strength of the wiki is that you can text search through everything in the wiki all at once. That does not work for Google Docs on Shared Drives. Google Docs and Sheets stored on FSGW Shared Drives are a great tool, but without someone who knows which information is in what Google Doc, even that information can effectively be lost.\\ \\
-  * To create a new page:
+  - With information that people are not comfortable having online even with the wiki's access control, or information that is too much trouble to make generally online accessible, what should go in the wiki is a description of the information (brief but not TOO brief) and how to access it. That makes the information's existence searchable, which is a big win.
-    - Add it a link to it on the index page you think it belongs under.
+=====Mechanics=====
+  * Do not write long documents in the wiki using wiki markup, longer than a page or 2 - It's not meant for that, especially it's clumsy for formatting long documents.
+    * You can use a word processor and post a PDF here.
+    * [[wiki:publish_from_google|How to Publish a Google Doc or Sheet for web viewing]]\\ \\
+  * Use wiki markup to create all the index pages, and the short information pages.\\ \\
+  * How to add a new page:
+    - Choose a title and filename for your page
+      * The title is to inform humans what the page is about, can be fairly long if needed for clarity
+      * The filename should be short, say 40 characters max. It should express what the page is about, but briefly.
+    - Choose an index page that you think your page belongs under
+      * If you don't find a matching index page, then maybe this page needs a new index page. If so, create that new index page.
+    - Decide where in the index your link makes sense being. Maybe rearrange the index if that would improve clarity.
+    - Edit the chosen index page to add a link to your page, like this: **%%[[filename|title]]%%**
     - After you save your index page change, the new page link will display in red, because it has not been created.
     - Click on the red link, which displays a page saying: "This topic does not exist yet" and "You've followed a link to a topic that doesn't exist yet. If permissions allow, you may create it by clicking on **Create this page**."
-    - Click on the **Create this page** pencil icon with a plus (+) sign, the uppermost icon to the right of the main window
+    - Click on the **Create this page** pencil icon with a plus (+) sign, the top icon to the right of the editing window.
     - An empty page editing window will be displayed
     - On the first line, put the page title with 6 equal signs on each side: ======Page Title======
     - I suggest saving your new page at this point, so it will now exist.
-    - Continue adding to your new page.
+    - Continue adding to your new page.\\ \\
-  - Etc, etc...
+  * Etc, etc...