Skip to content

Commit cfba2ce

Browse files
committed
fixing readme
1 parent 5df92fa commit cfba2ce

File tree

1 file changed

+43
-38
lines changed

1 file changed

+43
-38
lines changed

README.md

Lines changed: 43 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,108 +1,113 @@
11
# BELLATRIX-JavaScript
2-
BELLATRIX Tailor-made Test Automation Framework
2+
3+
## BELLATRIX Tailor-made Test Automation Framework
34

45
Customize and extend our cross-platform framework to perfectly fit your needs. Start on top of hundreds of best practice features and integrations.
56

67
Contains the full source code of BELLATRIX Test Automation Framework and Templates for faster usage
78

89
BELLATRIX is not a single thing it contains multiple framework libraries, extensions and tools. The tool is built to be cross-platform, however some of the features can be used under Windows since they are written for Visual Studio.
910

10-
Simple Installation
11+
## Simple Installation
1112

1213
- Download the BELLATRIX projects as a zip file from the Code green button in the right corner.
13-
-Unzip it. Open BELLATRIX-JavaScript in Visual Studio Code.
14-
- Open terminal and type npm ci in the root of the project.
14+
- Unzip it. Open BELLATRIX-JavaScript in Visual Studio Code.
15+
- Open terminal and type npm ci in the root of the project.
1516
- In order to run the sample tests, navigate to the example folder with terminal and type npm run test.
16-
- You can try to write a simple test yourself.
17+
- You can try to write a simple test yourself.
1718
- For an in-depth revision of all framework features you can check the official documentation
1819

19-
Running Tests through CLI
20+
## Running Tests through CLI
2021

2122
To execute your tests via command line in Continues Integration (CI), you can use the Bellatrix CLI through an npm script.
2223

2324
- Navigate to the folder of your test project.
2425
- Open the CMD there.
2526
- Execute the following command:
2627

27-
bellatrix <path>
28+
`bellatrix <path>`
2829

2930
where path is an optional argument for a path to the tests folder, either relative or absolute.
3031

3132
Filters and other more advanced configurations will be supported in a future version.
3233

3334
Our project uses Semantic Versioning (SemVer) for clear and predictable version management. Each release is tagged with a unique version number that reflects the nature of the changes made.
34-
Tags and Releases
3535

36-
Tags: We create Git tags for each release to mark specific points in the project's history, making it easier for users to switch between versions.
37-
Release Notes: Detailed notes accompany each release, highlighting new features, bug fixes, and any breaking changes.
36+
## Tags and Releases
37+
38+
Tags: We create Git tags for each release to mark specific points in the project's history, making it easier for users to switch between versions.
39+
Release Notes: Detailed notes accompany each release, highlighting new features, bug fixes, and any breaking changes.
3840

39-
Accessing Releases
41+
## Accessing Releases
4042

4143
Users can access the specific releases directly from our GitHub repository's Releases page or BELLATRIX website's roadmap section. Each release includes a tag, a summary of changes, and assets (if applicable).
4244
Integrating BELLATRIX as a Submodule in Your Project
4345
Adding BELLATRIX as a Submodule
4446

4547
To leverage a specific version of BELLATRIX in your project, you can add it as a Git submodule. This allows you to keep your copy of BELLATRIX up to date or locked to a specific version, depending on your project's needs.
4648

47-
Navigate to Your Project Directory: Open a terminal and change to the directory where your project is located.
48-
Add BELLATRIX as a Submodule: Use the following Git command to add BELLATRIX as a submodule to your project:
49+
Navigate to Your Project Directory: Open a terminal and change to the directory where your project is located.
50+
Add BELLATRIX as a Submodule: Use the following Git command to add BELLATRIX as a submodule to your project:
4951

50-
git submodule add https://github.com/BELLATRIX-Library/BELLATRIX.git path/to/submodule
52+
`git submodule add https://github.com/BELLATRIX-Library/BELLATRIX.git path/to/submodule`
5153

5254
Replace path/to/submodule with the relative path within your project where you'd like the BELLATRIX submodule to reside. Initialize and Clone the Submodule: If you're adding the submodule for the first time, initialize your local configuration file and clone the BELLATRIX repository as follows:
5355

54-
git submodule update --init --recursive
56+
`git submodule update --init --recursive`
5557

5658
Checking Out a Specific Tag (Release Version)
5759

5860
After adding BELLATRIX as a submodule, you might want to use a specific release version rather than the latest commit on the main branch.
5961

60-
Navigate to the Submodule Directory: Change into the BELLATRIX submodule directory within your project:
62+
Navigate to the Submodule Directory: Change into the BELLATRIX submodule directory within your project:
6163

62-
cd path/to/submodule
64+
`cd path/to/submodule`
6365

64-
Fetch All Tags from the BELLATRIX Repository: To ensure you have a list of all available tags, fetch them:
66+
Fetch All Tags from the BELLATRIX Repository: To ensure you have a list of all available tags, fetch them:
6567

66-
git fetch --tags
68+
`git fetch --tags`
6769

68-
Checkout the Desired Tag: Check out the specific tag (release version) you want to use by replacing <tagname> with the desired version:
70+
Checkout the Desired Tag: Check out the specific tag (release version) you want to use by replacing <tagname> with the desired version:
6971

70-
git checkout tags/<tagname>`
72+
`git checkout tags/<tagname>`
7173

7274
For example, if you want to check out version v3.9.0.0, you would use: git checkout tags/v3.9.0.0
7375

74-
Commit the Submodule Change: Navigate back to your project's root directory, and commit the change to the submodule reference:
76+
Commit the Submodule Change: Navigate back to your project's root directory, and commit the change to the submodule reference:
7577

76-
cd ../..
77-
git add path/to/submodule
78-
git commit -m "Update BELLATRIX submodule to v3.9.0.0"
78+
`cd ../..`
79+
`git add path/to/submodule`
80+
`git commit -m "Update BELLATRIX submodule to v3.9.0.0"`
7981

8082
This process ensures that your project uses a specific, fixed version of BELLATRIX, providing stability and consistency across environments or deployments.
8183
Contributing to Our Project
8284

8385
We welcome contributions from the community, whether it's in the form of bug reports, feature requests, documentation improvements, or code contributions.
84-
Getting Started
8586

86-
Fork the Repository: Start by forking the repository to your GitHub account. This provides you with a personal workspace for making changes.
87-
Clone Your Fork: Clone your fork to your local machine to start working on the changes.
87+
## Getting Started
88+
89+
Fork the Repository: Start by forking the repository to your GitHub account. This provides you with a personal workspace for making changes.
90+
Clone Your Fork: Clone your fork to your local machine to start working on the changes.
8891

89-
Making Changes
92+
## Making Changes
9093

91-
Create a Feature Branch: From your fork, create a new branch for your work. This keeps your changes organized and separate from the main branch.
92-
Commit Your Changes: Make your changes locally, and commit them to your feature branch. Use clear and descriptive commit messages.
94+
Create a Feature Branch: From your fork, create a new branch for your work. This keeps your changes organized and separate from the main branch.
95+
Commit Your Changes: Make your changes locally, and commit them to your feature branch. Use clear and descriptive commit messages.
9396

94-
Submitting Contributions
97+
## Submitting Contributions
9598

96-
Pull from Upstream: Before submitting your contribution, pull the latest changes from the upstream main branch into your feature branch to minimize merge conflicts.
97-
Push to Your Fork: Push your changes to your fork on GitHub.
98-
Open a Pull Request (PR): Submit a pull request from your feature branch to the main branch of the original repository. Provide a clear description of your changes and any relevant issue numbers.
99+
Pull from Upstream: Before submitting your contribution, pull the latest changes from the upstream main branch into your feature branch to minimize merge conflicts.
100+
Push to Your Fork: Push your changes to your fork on GitHub.
101+
Open a Pull Request (PR): Submit a pull request from your feature branch to the main branch of the original repository. Provide a clear description of your changes and any relevant issue numbers.
99102

100-
Code Review
103+
## Code Review
101104

102105
Review Process: Your PR will be reviewed by the project maintainers. They may provide feedback or request changes. Be open to discussion and willing to make adjustments as needed.
103-
After Your PR is Merged
106+
107+
## After Your PR is Merged
104108

105109
Once your PR is merged, your contributions will become part of the project. You can then safely delete your feature branch.
106-
Supported Code Editors
110+
111+
## Supported Code Editors
107112

108113
The recommended code editor for writing BELLATRIX tests is Visual Studio Code

0 commit comments

Comments
 (0)