# features
* support posts stats report
* '/links' command
* '/help' command
# report
## format
1. provide weekly statistics for last rolling month.
2. run same statistics over all posts history
3. statistics to be provided in json, yaml or other machine readable format

## metrics
1. provide number of posts per tag (fallback on 'other')
2. provide number of posts per class as a docs page
3. classify kapa ai posts and also normal support posts

# commands
1. provide a command '/links' that can briefly mention relevant links to docs pages sections (max 3 links)
2. provide a command '/help' that can summon ai for help in the current post thread

## design guide
* tags context is to be mapped from relevant docs page or pages (will be provided)
* every post will be assigned 1, 2 or max 3 tags/pages (weights to be provided)
* same stats to cover kapa, normal support, and one with both combined.
* the similarties search to docs sections is to embed each doc page section separately, including a page context (page category, summary, higher headings)
* fallback of page section can be a link to the page url without sections, which means pages to have embeddings weighing section embeddings or re-embedding all page content, if token limit crossed then summarize page before embedding.

## extensions
* commands are meant to operate in support posts, both kapa and normal support. future extension should allow them to be used in any channel by weighing the last 10 posts increasingly and focus on last one.

# comments
* as stressed by community members (e.g. Oliver) the '/links' or '/tbd' command would be like '/docs' or replacement for it e.g. '/docs++' : give me all relevant docs to this conversation without me bothering typing keywords - smart /docs - search.