hackforla / hackforla/product-management

Knowledge Base - Evaluation of potential solutions

Open
#342 11 comments 0 reactions 0 assignees View on GitHub
complexity: missing feature: missing help wanted milestone: missing Project Managment role: missing size: missing time sensitive
Dominant language
No language data
Stars
55
Forks
5
PR merge metrics
No merged PRs in 30d

Description

### Overview
We need to decide what type of solution we use to create and manage our Knowledge Base. In this issue, we will add pros and cons for a solution we evaluate, to be shared and decided upon by the PM CoP group.

HackforLA is a volunteer run organization which means that significant institutional and tribal knowledge gained by a volunteer is lost when they leave us. Consequently, new volunteers must relearn historical, strategic, operational, and tactical knowledge in an unstructured way. This creates a burden for the existing team members as well as increases the steepness of the learning curve and increases the ramp up time for a new volunteer.

### Action Items
- Choose a knowledge base solution and add it to a comment below.
- Add a comment as soon as you decide on a solution, to avoid duplicating research
- Review the solution and add your feedback to your comment.

* If you evaluate a solution that will not work for our purposes, explain your reasons as it is helpful to know why we should not consider it.
* Choose another solution to evaluate (if you have time).

### Must Have for software solution
- Must be free
- Must have a search function that looks inside of the files, not just the titles
- Ideally it can be hosted on GitHub Pages (so it is easy to install)
- Will consider externally hosted option if:
- It is free
- Has more options than are available from a GitHub Pages site.
### Should have
ability to add labels or tags that would keep us from having to set up a heretical navigation

### number of users
for people to view : unlimited
editors (limited access): 200 active
editor (all access): 5
editors: (ideally as many non active editors as we need) - nice to have

### Goal is to have a discussion at the CoP Meeting on July 8, 2022 to decide on a solution.

### Places to start:
- [A guide to the best knowledge base software](https://www.zendesk.com/service/help-center/knowledge-base-software)
- [The 11 Best Open Source Knowledge Base Software for 2022](https://helpjuice.com/blog/open-source-knowledge-base)
- [The Best SaaS Knowledge Base Software [2022]]( https://helpjuice.com/blog/saas-knowledge-base)

### Spreadsheet
- [Comparative Analysis](https://docs.google.com/spreadsheets/d/1m74sIauy_VZIgsdth74IEiVvGSSUsZzp92WhVNHE_Yw/edit#gid=0)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.