Skip to content

Commit a307b36

Browse files
committed
fixed documentation formatting
1 parent 4c99fac commit a307b36

File tree

1 file changed

+27
-27
lines changed

1 file changed

+27
-27
lines changed

test2text/pages/documentation.py

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -7,72 +7,72 @@ def show_documentation():
77
88
## About the Application
99
10-
**Test2Text** is a tool for computing requirement's coverage by tests and generating relevant reports.
11-
The application provides a convenient interface for analysis the relationships between test cases and requirements.
10+
**Test2Text** is a tool for computing requirement's coverage by tests and generating relevant reports.
11+
The application provides a convenient interface for analysis the relationships between test cases and requirements.
1212
""")
1313
st.divider()
1414
st.markdown("""
1515
## HOW TO USE
1616
1717
### Upload data
18-
Click :gray-badge[:material/database_upload: Annotations] or :gray-badge[:material/database_upload: Requirements] to upload annotations and requirements from CSV files to the app's database.
18+
Click :gray-badge[:material/database_upload: Annotations] or :gray-badge[:material/database_upload: Requirements] to upload annotations and requirements from CSV files to the app's database.
1919
2020
### Renew data
21-
Click :gray-badge[:material/cached: Controls] to transform missed and new texts into numeral vectors (embeddings).
22-
Update distances by embeddings for intelligent matching of requirements and annotations.
21+
Click :gray-badge[:material/cached: Controls] to transform missed and new texts into numeral vectors (embeddings).
22+
Update distances by embeddings for intelligent matching of requirements and annotations.
2323
2424
### Generate reports
25-
Click :gray-badge[:material/publish: Requirement's Report] or :gray-badge[:material/publish: Test cases Report] to make a report.
26-
Use filters to select desired information. Analyze selected requirements or test cases by showed and plotted distances
25+
Click :gray-badge[:material/publish: Requirement's Report] or :gray-badge[:material/publish: Test cases Report] to make a report.
26+
Use filters to select desired information. Analyze selected requirements or test cases by showed and plotted distances
2727
2828
### Visualize saved data
29-
Click :gray-badge[:material/dataset: Visualize vectors] to plot distances between vector representations of all requirements and annotations.
29+
Click :gray-badge[:material/dataset: Visualize vectors] to plot distances between vector representations of all requirements and annotations.
3030
3131
""")
3232
st.divider()
3333
st.markdown("""
3434
### Methodology
35-
The application use a pre-trained transformer model from the [sentence-transformers library](https://huggingface.co/sentence-transformers), specifically [nomic-ai/nomic-embed-text-v1](https://huggingface.co/nomic-ai/nomic-embed-text-v1), a model trained to produce high-quality vector embeddings for text.
36-
The model returns, for each input text, a high-dimensional NumPy array (vector) of floating point numbers (the embedding).
37-
This arrays give us a possibility to calculate Euclidian distances between test cases annotations and requirements to view how similar or dissimilar the two texts.
35+
The application use a pre-trained transformer model from the [sentence-transformers library](https://huggingface.co/sentence-transformers), specifically [nomic-ai/nomic-embed-text-v1](https://huggingface.co/nomic-ai/nomic-embed-text-v1), a model trained to produce high-quality vector embeddings for text.
36+
The model returns, for each input text, a high-dimensional NumPy array (vector) of floating point numbers (the embedding).
37+
This arrays give us a possibility to calculate Euclidian distances between test cases annotations and requirements to view how similar or dissimilar the two texts.
3838
""")
3939

4040
st.markdown("""
4141
#### Euclidean (L2) Distance Formula
42-
The Euclidean (L2) distance is a measure of the straight-line distance between two points (or vectors) in a multidimensional space.
43-
It is widely used to compute the similarity or dissimilarity between two vector representations, such as text embeddings.
42+
The Euclidean (L2) distance is a measure of the straight-line distance between two points (or vectors) in a multidimensional space.
43+
It is widely used to compute the similarity or dissimilarity between two vector representations, such as text embeddings.
4444
""")
4545
st.markdown("""
46-
Suppose we have two vectors:
47-
""")
48-
st.latex(r"""
49-
[ \mathbf{a} = [a_1, a_2, ..., a_n] ],
46+
Suppose we have two vectors:
5047
""")
5148
st.latex(r"""
52-
[ \mathbf{b} = [b_1, b_2, ..., b_n] ]
53-
""")
49+
[ \mathbf{a} = [a_1, a_2, ..., a_n] ],
50+
""")
51+
st.latex(r"""
52+
[ \mathbf{b} = [b_1, b_2, ..., b_n] ]
53+
""")
5454

5555
st.markdown("""
56-
The L2 distance between **a** and **b** is calculated as:
57-
""")
56+
The L2 distance between **a** and **b** is calculated as:
57+
""")
5858

5959
st.latex(r"""
60-
[ L_2(\mathbf{a}, \mathbf{b}) = \sqrt{(a_1 - b_1)^2 + (a_2 - b_2)^2 + \cdots + (a_n - b_n)^2} ]
60+
[ L_2(\mathbf{a}, \mathbf{b}) = \sqrt{(a_1 - b_1)^2 + (a_2 - b_2)^2 + \cdots + (a_n - b_n)^2} ]
6161
""")
6262

6363
st.markdown("""
64-
Or, more compactly:
64+
Or, more compactly:
6565
""")
6666

6767
st.latex(r"""
68-
[ L_2(\mathbf{a}, \mathbf{b}) = \sqrt{\sum_{i=1}^n (a_i - b_i)^2} ]
68+
[ L_2(\mathbf{a}, \mathbf{b}) = \sqrt{\sum_{i=1}^n (a_i - b_i)^2} ]
6969
""")
7070

7171
st.markdown("""
72-
- A **smaller L2 distance** means the vectors are more similar.
73-
- A **larger L2 distance** indicates greater dissimilarity.
72+
- A **smaller L2 distance** means the vectors are more similar.
73+
- A **larger L2 distance** indicates greater dissimilarity.
7474
""")
7575

7676
st.markdown("""
77-
This formula is commonly used for comparing the semantic similarity of embeddings generated from text using models like Sentence Transformers.
77+
This formula is commonly used for comparing the semantic similarity of embeddings generated from text using models like Sentence Transformers.
7878
""")

0 commit comments

Comments
 (0)