|
1 | 1 | # TorqueLearn v3 |
2 | 2 | A rookie's guide to Torque and the skills required for it. |
3 | 3 |
|
4 | | -# Running Server |
5 | | -Netlify hosts this server through the Texas Torque GitHub. Hence, only pushing to the Master branch will enact any changes. |
| 4 | +# Server Management |
| 5 | +Netlify hosts this server through the Texas Torque GitHub. Hence, only pushing to the Master branch will enact any changes. Netlify, the provider for the website, automatically detects any pushes and auto-publishes them to the website. Hence, it is recommended to work in branches to test before pushing to master. |
| 6 | + |
| 7 | +To access the Netlify page on the website, login on Netlify and link your GitHub account. When it detects you are a member of the Texas Torque programming group, it will automatically grant you access to the page. |
6 | 8 |
|
7 | 9 | ## Development |
8 | | -TorqueLearn3 is built on Astro, a HTML/CSS/JavaScript framework. It can be installed through *npm*. Instruction can be found [here](https://docs.astro.build/en/install-and-setup/). |
| 10 | +TorqueLearn3 is built on Astro, a `HTML`/`CSS`/`JavaScript` framework. It can be installed through `npm`. Instruction for Astro can be found [here](https://docs.astro.build/en/install-and-setup/). |
9 | 11 |
|
10 | 12 | ### Launching |
11 | | -To launch a dev server, navigate to the root folder and run the command `npm run dev`. This will establish a localhost:4321 server. This website will automatically update upon file changes and will display any crash errors on the website. |
| 13 | +To launch a dev server, navigate to the root folder and run the command `npm run dev`. This will establish a localhost server on the port 4321. This website will automatically update upon file changes and will display any crash errors on the website. When launched, the website can be access through [127.0.0.1:4321](http://127.0.0.1:4321) or [localhost:4321](http://localhost:4321). |
12 | 14 |
|
13 | 15 | Other devices can connect to this through standard port forwarding. |
14 | 16 |
|
15 | | -### Contribution |
16 | | -After I (Davis Jenney) have graduated, I will very likely not be able to participate in its facilitation and development. Hence, Decap CMS and Netlify have been used. Subsection mentors and Mr. Wolf (or any permitted individual) can add information to the wiki through adding, editing, or removing pages. This is password protected and all authors are documented, alongside a time and date. GitHub also stores any previous versions that can be restored if need be. Documentation for Decap CMS can be found [here](https://decapcms.org/docs/intro/).\ |
| 17 | +## Contribution |
| 18 | +After I (Davis Jenney) have graduated, I will very likely not be able to participate in its facilitation and development. Hence, Decap CMS and Netlify have been used. Subsection mentors and Mr. Wolf (or any permitted individual) can add information to the wiki through adding, editing, or removing pages after logging in through an email and password. GitHub also stores any previous versions that can be restored if need be. Documentation for Decap CMS can be found [here](https://decapcms.org/docs/intro/). |
| 19 | + |
| 20 | +### Registration |
| 21 | +To register an editor, go to the Netlify application and invite a user through the Identity section in the settings. Using their email, register them and make them an editor. Upon their acceptance of the invite, they will be prompted to make a password. This email and password can then be used to login on the Admin page to edit documents. |
17 | 22 |
|
18 | | -## Registration |
19 | | -To register an editor, go to the Netlify application and invite a user through the Identiy section in the settings. Using their email, register them and make them an editor. Upon them accepting it, send a password reset email to them to let them set a password. From there, they can sign in through the admin page. |
| 23 | +If need be, users can be deleted through this same Netlify page. This is recommended after students graduate or permission needs to be revoked. |
20 | 24 |
|
21 | 25 | # Authors |
22 | | -[Davis Jenney](https://github.com/OrangeTurtle77) (2023-2027) |
| 26 | +[Davis Jenney](https://github.com/OrangeTurtle77) (2023-2027) |
0 commit comments