Hey all! This is going to be a longer post, but consider it essential and necessary. Plus, who wouldn't want to read a ton of what Nate writes???
So, what's going on?
I decided to re-consider the steps I've taken thus far when it comes to the online form of the Manual. First, I realized that though WikiMedia is a great platform (I mean, it runs the best site on Earth), it is still a really different platform. To properly use it we would all need to learn how to use a special markup language. Plus, the site is pretty slow and it wouldn't lend itself to simple deployments to the final site.
{{<hintinfo>}}
**Note**
Don't worry! This page will be edited before we release anything so we aren't *too* unprofessional ;)
{{</hint>}}
Instead, I figured that it would be best to look at POM when it comes to the platform:
## overview
### Purpose, Outcomes, and Methods
**Purpose**: To easily and effectively communicate the CultureBridge project to site visitors.
**Outcomes**:
- Portability: a site which can last forever with very little maintenance. This really means:
- Universal input: a form of writing which is well-supported across the web.
- Universal output: a static site (plain HTML, CSS, & JS) - which can be run from files on your computer or a website
- Multi-format: the ability to download the entire site in HTML, PDF, markdown, etc.
- Ease-of-use: both for the end-user and for us – the writers. The website should be easy to navigate. We need something which is easy to learn how to use.
- Beautiful: the simple fact is, a beautiful site which focuses on content is better for the situation.
Version control: a permanent record of changes and additions (not just for us, but for future creators).
**Methods**: Well, here we are! The following is meant to introduce you to what comes next and how you can use it.
## the site
You are here! For now, we can use `culturebridge.ga` as the website. But no worries, it would be as simple as 1 … 2 … and 3 to change it.
{{<expand"question">}}
Have we considered `culturebridgetulsa.org`?
Though maybe the shorter `culturebridge` is better `¯\_(ツ)_/¯`.
We could also use `culturebridgetulsa.com` if we wanted to replace our other site.
{{</expand>}}
### The Layout
{{<tabs"uniqueid">}}
{{<tab"Mobile">}}
## Mobile Layout
There are two "menus" you have to know about. First, the actual menu. This is the three bars in the top left. Click on it and you will see a big "CultureBridge Tulsa", a search input, and a Table of Contents. The search function is still a work-in-progress, so it may or may not work.
The table of contents you see here is site-wide. It links to all of the major pages. Think of these as chapters in a book.
{{<hintinfo>}}
**Did you know?** The theme of our site is actually called "Hugo Book". How appropriate!
{{</hint>}}
You should see the Modules section, the Supplements section, and an Info section. These will be the major parts of the site. One day you will be able to click on "Modules" and see a page explaining what the modules are and linking to all of them. Or, you could jump right in and go to the Module you want (go ahead! try looking at the Debrief or Intro).
The same thing will happen with the Supplements and the Info section.
{{<expand"WhatistheInfosection?">}}
The Info section is the miscellaneous items we talked about going into the Wiki. Examples include the YPI page, the New Tulsans page, a history & timeline of our experience in CultureBridge, and more! We can pretty much add whatever we want.
{{</expand>}}
There is
{{</tab>}}
{{<tab"Desktop">}}
## Desktop Layout
For everyone reading this on a computer, I might as well come out and say it: **I love you**.
Why? Because the web is just so much better on a big screen. Why do we limit ourselves to tiny little things which make life **so much harder** for programmers and designers?
So, I'm not going to waste your time here. On a computer it's much easier to see the Menu and the single-page Table of Contents. Everything is pretty intuitive. But if you're curious, go ahead and switch over to the "Mobile" tab to read about it all.
Love you,
Nate
{{</tab>}}
{{</tabs>}}
## Netlify CMS
I'm jumping ahead to this section cause it's the most necessary. The [Markdown](#markdown) section is also somethat important, if you want to be cool, but it's not strictly necessary, as you will see in this section.
**What is Netlify CMS?**
A CMS is a "Content Management System". In other words, it's a system which helps us manage our content. Or, in even different other words, it's a thing we will use to write, edit, style, and "push" each page on the site.
{{<hintinfo>}}
"Push" here means to send the content to our backend system which will automatically add it to the website. To know what it actually means, in a technical sense, read the rest of this Documentation (yes, I am trying to convert you all into technically literate people). The best way to learn tech is to read, to practice, to randomly explore, and [to hack](https://ijams.tk/posts/rules/#hacker).
{{</hint>}}
In summary, these are the instructions for how you will make content on this site.
### Making your account
Whoa! An account! Get excited everyone, this is where it gets fun. It's also where you need to be using a computer, not a phone :)
First, go to [culturebridge.ga/admin/](https://culturebridge.ga/admin/).
