Add documentation on how the HTML reports are created
Open
@tromai is already working on this.
Since Jun 14, 2023.
documentation
report
- Dominant language
- Python
- Stars
- 210
- Forks
- 36
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 2
Description
Description
This PR is used to track the progress of adding the documentation for maintaining the HTML reports created by Macaron (in the Sphinx documentation's Deverloper Reference section or as a README).
Some of contents that I currently think of (and potentially add more in the future):
- The extensions filters and tests defined in https://github.com/oracle/macaron/blob/main/src/macaron/output_reporter/jinja2_extensions.py:
- How we can use it?
- How it's passed into the Jinja2 environment
- How to render the tree-view structure in the HTML reports (i.e. how the recursive feature of for control structure in Jinja2 is utilized. how the CSS and Javascript in the HTML files are used, etc.)
- Inheritance and macros of Jinja2 templates here
- White-space control
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.
Assessment
This issue has not been assessed yet.