hackforla / hackforla/product-management
Knowledge Base - Evaluation of potential solutions
- 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
Assessment
This issue has not been assessed yet.