Minor doc updates

This commit is contained in:
Bryan Ashby 2019-02-15 13:55:11 -07:00
parent 7d82935986
commit 04c8167a15
No known key found for this signature in database
GPG Key ID: B49EB437951D2542
1 changed files with 10 additions and 7 deletions

View File

@ -1,16 +1,17 @@
# Introduction # Introduction
This document covers basic upgrade notes for major ENiGMA½ version updates. This document covers basic upgrade notes for major ENiGMA½ version updates.
# Before Upgrading # Before Upgrading
* Always back up your system! * Always back up your system!
* Seriously, always back up your system!
* At least back up the `db` directory and your `menu.hjson` (or renamed equivalent) * At least back up the `db` directory and your `menu.hjson` (or renamed equivalent)
# General Notes # General Notes
Upgrades often come with changes to the default `menu.hjson`. It is wise to ## Configuration File Updates
use a *different* file name for your BBS's version of this file and point to In general, look at the `menu_template.in.hjson`, and `config_template.in.hjson` as well as the defualt `luciano_blocktronics/theme.hjson` files when you update. These files may come with new sections you wish to merge into your system!
it via `config.hjson`. For example:
### menu.hjson
Upgrades often come with changes to the default `menu_template.in.hjson`. It is wise to use a *different* file name for your BBS's version of this file and point to it via `config.hjson`. For example:
```hjson ```hjson
general: { general: {
@ -21,6 +22,9 @@ general: {
After updating code, use a program such as DiffMerge to merge in updates to After updating code, use a program such as DiffMerge to merge in updates to
`my_bbs.hjson` from the shipping `menu.hjson`. `my_bbs.hjson` from the shipping `menu.hjson`.
### theme.hjson
Any custom themes you have created may now be missing features as well. Take a look at the default `luciano_blocktronics/theme.hjson` file. You can use missing sections in your `theme.hjson` (which will generally correspond to sections you've also merged in to your `menu.hjson`).
# Upgrading the Code # Upgrading the Code
Upgrading from GitHub is easy: Upgrading from GitHub is easy:
@ -32,7 +36,6 @@ rm -rf npm_modules # do this any time you update Node.js itself
npm install npm install
``` ```
# Problems # Problems
Report your issue on Xibalba BBS, hop in #enigma-bbs on Freenet and chat, or Report your issue on Xibalba BBS, hop in #enigma-bbs on Freenet and chat, or
[file a issue on GitHub](https://github.com/NuSkooler/enigma-bbs/issues). [file a issue on GitHub](https://github.com/NuSkooler/enigma-bbs/issues).