cityofaustin / cityofaustin/atd-data-tech

[Spike ] Research Alternatives to Gitbook for documenting public help guides/tutorials

Open
#28,014 0 comments 0 reactions 1 assignee Claimed by @KaroEngstrom View on GitHub
Team: Apps Type: Research Workgroup: DTS
Dominant language
No language data
Stars
33
Forks
3
Avg merge
5d 14h
Merged PRs (30d)
2

Description

## Alternatives to Gitbook for documenting public help guides/tutorials

- Gitbook may have better features on their paid platform that we have not been using so far
### Knack
- Pro - same platform; easy creation of pages and text
- Con - difficult image mgmt + accessibility
### Github
- We would have to host image in GitHub (can’t support videos)
- A read only page to link to from Knack
### SharePoint
- Not usually public-facing but Michelle Ahmad, the new M365 person, seems to consider it more routine
### PDFs
- Pro- easy creation in Word, Excel, or Miro
- Static Content: embedded PDF they can download (Chrispin suggestion)
- Con - clunky maintenance, remediation can be cumbersome with tags and reading order
### Miro
- Pro- easy and fun to create
- Con - accessibility = total wild card?
### Scribe
- We have 1 paid license for it
- Would need to do further research
### Other Possibilities
- Obsidian
- Notion
- Plasmic
- Would Mateo/devs have any suggestions from open source?
### Rethinking the Model
- Better ways to provide the information to specific apps - more embedded/blended model?

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.