Add context to the
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 65/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Domain
- documentation
Research direction
Start by reading docs/getting_started/guided/guided.md and docs/getting_started/zeroshot/zeroshot.md to compare their existing explanations. Add reciprocal cross-references and a short comparison, then verify that both guides clearly explain when each approach is appropriate and that the links resolve.
Written by the indexing model from the issue text.
Description
Feature request
Cross-reference from the zeroshot doc to the guided doc (and vice versa).
Add a short explainer of the differences between zeroshot and guided.
Motivation
Two reasons:
-
I used zeroshot topic modeling and only later found that there is a very similar approach that I would have like to have known earlier. It would be good if users would be cross-referenced to alternative approaches (from zeroshot to guided and from guided to zeroshot) when reading the documentation.
-
Also, I found it not easy to compare these approaches as there is no explicit comparison in the docs between these two approaches. An explicit comparison would make it easier for users to understand the differences between zeroshot and guided.
Your contribution
This guide would go into the docs/getting_started/guided/guided.md markdown file:
!!! Note
Difference between Zero-shot and Guided BERTopic:
Guided BERTopic is similar - yet not equivalent - to [Zeros-shot Topic Modeling](https://maartengr.github.io/BERTopic/getting_started/zeroshot/zeroshot.html).
Use Guided BERTopic to boost certain keyword's importance. Use [Zeros-shot Topic Modeling](https://maartengr.github.io/BERTopic/getting_started/zeroshot/zeroshot.html) to try to categorize documents into predefined topics ("zero-shot topics") before the clustering the remaining, unclassified documents, using the default unsupervised BERTopic topic exploration algorithm.
This guide would go into the docs/getting_started/zeroshot/zeroshot.md markdown file:
!!! Note
Difference between Zero-shot and Guided BERTopic:
Zeros-shot Topic Modeling is similar - yet not equivalent - to [Guided BERTopic](https://maartengr.github.io/BERTopic/getting_started/guided/guided.html). Use [Guided BERTopic](https://maartengr.github.io/BERTopic/getting_started/guided/guided.html) to boost certain keyword's importance. Use [Zeros-shot Topic Modeling](https://maartengr.github.io/BERTopic/getting_started/zeroshot/zeroshot.html) to try to categorize documents into predefined topics ("zero-shot topics") before the clustering the remaining, unclassified documents, using the default unsupervised BERTopic topic exploration algorithm.
- Dominant language
- Python
- Stars
- 7.8k
- Forks
- 921
- Avg merge
- 22h 24m
- Merged PRs (30d)
- 5
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from MaartenGr/BERTopic
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug
Difficulty 3/5 1-2 days Newbie friendliness 68/100
-
bug
Difficulty 3/5 1-2 days Newbie friendliness 72/100
All issues in MaartenGr/BERTopic
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100