-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat(doc): include bao test framework introduction #71
base: wip/testing
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nothing to add @Diogo21Costa , seems good to me as a small introduction to the document, since the next section I assume you will explain the "architecture" of the framework.
Does this PR supersedes #65 ? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To be completely honest, the C library and Nix build system descriptions are a bit confusing. From these descriptions I would not get what they are meant to do.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please rebase it with main and solve the checker issues.
cabeb59
to
005c822
Compare
8c0fa76
to
f2160d8
Compare
f2160d8
to
198690e
Compare
Signed-off-by: Diogo21Costa <[email protected]>
198690e
to
020fe09
Compare
@Diogo21Costa TBH, I still think these descriptions are confusing, especially the C library one. Using simpler language, with fewer adjectives and more straight-to-the-point ideas, would be best. |
source/development/testing.rst
Outdated
1. **C Library** - This library that streamlines testing by providing macros, pre-processed logging | ||
prompts, and an entry-point-based system, aiming to facilitating the integration of developer | ||
tests in the software stack, such as the hypervisor or guest components. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
1. **C Library** - This library that streamlines testing by providing macros, pre-processed logging | |
prompts, and an entry-point-based system, aiming to facilitating the integration of developer | |
tests in the software stack, such as the hypervisor or guest components. | |
1. **C Library** - This library provides a framework for writing tests. It defines (i) a runtime that automates the invocation of function unit tests and (ii) an API that mainly provides a way of outputing test results in a standard format that can be parsed by the Python Tool (see below). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, fixed!
source/development/testing.rst
Outdated
2. **Nix Build System** - The Nix Build System introduces an abstraction layer for system builds, | ||
facilitating a modular construction of the software stack for comprehensive testing. It | ||
encompasses a series of nix recipes that allow the compilation and build of three distinct | ||
layers: (i) the hypervisor, (ii) multiple guests (e.g., baremetal, freeRTOS, etc.), and (iii) | ||
the firmware. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
2. **Nix Build System** - The Nix Build System introduces an abstraction layer for system builds, | |
facilitating a modular construction of the software stack for comprehensive testing. It | |
encompasses a series of nix recipes that allow the compilation and build of three distinct | |
layers: (i) the hypervisor, (ii) multiple guests (e.g., baremetal, freeRTOS, etc.), and (iii) | |
the firmware. | |
2. **Nix Build System** - The Nix Build System introduces an abstraction layer for system builds, | |
facilitating a modular construction of the target software stack used for testing. It | |
encompasses a series of nix recipes that allow the compilation and build of three distinct | |
layers: (i) the hypervisor, (ii) multiple guests (e.g., baremetal, freeRTOS, etc.), and (iii) | |
the firmware. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, fixed!
Signed-off-by: Diogo Costa <[email protected]>
PR Description
In this pull request, I'm adding content to the "Overview" section of the Bao test framework documentation.
This update focuses solely on the "Overview" section, providing an overview of the core components of the Bao test framework.
Do you have any suggestions or feedback concerning the content provided in the overview section?