Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added UserGuide template and filled in some information #30

Merged
merged 1 commit into from
Oct 10, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions UserGuide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# User Guide
In this project, we added two new features:

1. A search bar that can search for topics within a category.
2. A system to tag questions as answered/closed and tag answers as verified by a teacher (similar to Piazza)

The front-end components of these new features are implemented using our custom theme: `nodebb-theme-slackers`.

## Using our custom theme
Here is how to set up and use our custom theme.

#### Add it to node_modules
1. Make sure the directory `nodebb-theme-slackers` is located in the root directory (along with `public`, `src` for example)
2. Navigate to `nodebb-theme-slackers` (run `cd nodebb-theme-slackers/` from the root directory)
3. Run `npm link`
4. Navigate back to the root directory (run `cd ..`)
5. Run `npm link nodebb-theme-slackers`

#### Use the new custom theme
1. After making sure NodeBB is not running (run `./nodebb stop`), run `./nodebb reset -t nodebb-theme-slackers`. Now our new custom theme will be used when NodeBB is relaunched.
2. Make sure `redis-server` is running so that we can launch our project.
3. Launch NodeBB in your preferred way:
```
./nodebb reset -t nodebb-theme-slackers && ./nodebb build && ./nodebb start
```
4. Go to http://localhost:4567/ to see the new theme in action!

## Search bar
### How to use
Our search bar component is found under any category. After launching the local NodeBB app, **navigate to a category** (such as General Discussion or Announcements).

If you set up the theme properly, you should see a search bar in between the title and the tags/filters. Simply click on this search bar and type a search query. If there are existing topics within this category that contain that search query, they will be displayed. You can still click on any of these topics after being filtered and it will properly navigate you to within the topic.

### Automated testing
TODO (include file location of automated tests)

## Tags
### How to use
TODO
### Automated testing
TODO (include file location of automated tests)