Skip to content

Documentation improvement suggestion: embed-with-bgm-m3.md #3152

Open
@milvus-grammar-checker

Description

@milvus-grammar-checker

Document Path

grammar_test/embed-with-bgm-m3.md

Analysis Result

  1. Issue: Awkward phrasing
    Location: Line 2
    Original: "BGE M3 is named for its capabilities in Multi-Linguality, Multi-Functionality, and Multi-Granularity."
    Suggestion: "BGE M3 is named for its capabilities in multilingualism, multifunctionality, and multi-granularity."

  2. Issue: Redundant phrasing
    Location: Line 4
    Original: "BGE-M3 sets new benchmarks in multi-lingual and cross-lingual retrieval tasks."
    Suggestion: "BGE-M3 sets new benchmarks in multilingual and cross-lingual retrieval tasks."

  3. Issue: Awkward phrasing
    Location: Line 5
    Original: "Its unique ability to perform dense retrieval, multi-vector retrieval, and sparse retrieval within a single framework makes it an ideal choice for a wide range of information retrieval (IR) applications."
    Suggestion: "Its unique ability to perform dense, multi-vector, and sparse retrieval within a single framework makes it an ideal choice for a wide range of information retrieval (IR) applications."

  4. Issue: Chinglish expression
    Location: Line 8
    Original: "This class handles the computation of embeddings and returns them in a format compatible with Milvus for indexing and searching."
    Suggestion: "This class computes embeddings and returns them in a format compatible with Milvus for indexing and searching."

  5. Issue: Redundant phrasing
    Location: Line 10
    Original: "To use this feature, FlagEmbedding must be installed."
    Suggestion: "To use this feature, you must install FlagEmbedding."

  6. Issue: Awkward phrasing
    Location: Line 13
    Original: "Then, instantiate the BGEM3EmbeddingFunction:"
    Suggestion: "Next, instantiate the BGEM3EmbeddingFunction."

  7. Issue: Inconsistent formatting
    Location: Line 16
    Original: "- model_name (string)"
    Suggestion: "- model_name (string)"

  8. Issue: Inconsistent formatting
    Location: Line 18
    Original: "- device (string)"
    Suggestion: "- device (string)"

  9. Issue: Inconsistent formatting
    Location: Line 20
    Original: "- use_fp16 (bool)"
    Suggestion: "- use_fp16 (boolean)"

  10. Issue: Awkward phrasing
    Location: Line 23
    Original: "The expected output is similar to the following:"
    Suggestion: "The expected output resembles the following:"

  11. Issue: Awkward phrasing
    Location: Line 26
    Original: "The expected output is similar to the following:"
    Suggestion: "The expected output resembles the following:"

Overall, the text contains several instances of awkward phrasing, redundancy, and inconsistent formatting that can be improved for clarity and professionalism.

Suggested Action

Please make corresponding modifications and optimizations to the documentation based on the above analysis results.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions