Skip to content

Commit 2e5ae3e

Browse files
committed
chore: Linting
Signed-off-by: Eatham532 <78714349+Eatham532@users.noreply.github.com>
1 parent 1207365 commit 2e5ae3e

File tree

4 files changed

+35
-0
lines changed

4 files changed

+35
-0
lines changed

CONTRIBUTING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Before contributing, ensure you have:
2525
- Python 3.13+ (or any Python 3.x version)
2626

2727
- [uv](https://docs.astral.sh/uv/) for Python package management
28+
2829
- [uv](https://docs.astral.sh/uv/) (recommended) or `pip` for Python package management
2930

3031
- Git for version control
@@ -52,6 +53,7 @@ Before contributing, ensure you have:
5253
# Or use pip (standard Python installer)
5354
python -m pip install --upgrade pip
5455
python -m pip install -e .
56+
5557
```
5658

5759
3. **Activate the virtual environment**:

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,23 +13,33 @@ This is a **comprehensive digital textbook** aligned with the **NSW HSC Software
1313
The project is currently about **90% generated by AI**, with ongoing **human editing** for accuracy, context, and clarity. As a free and **open-source resource**, it is a work in progress and will continually evolve with community contributions.
1414

1515
**Key features include:**
16+
1617
* **Interactive Quizzes** for immediate self-assessment.
18+
1719
* Extensive **Python Code Samples** and real-world case studies.
20+
1821
* **Diagrams and Visualizations** for complex concepts.
1922

2023
## 📚 Syllabus Content
2124

2225
The content is organized directly according to the NESA syllabus modules.
2326

2427
### Year 11 Modules
28+
2529
* **Programming Fundamentals**: Software development life cycles, algorithms, data structures, and Python programming.
30+
2631
* **Object-Oriented Paradigm**: Core OOP concepts, design patterns, and practical implementation in Python.
32+
2733
* **Programming Mechatronics**: Integrating hardware and software, and an introduction to embedded systems.
2834

2935
### Year 12 Modules
36+
3037
* **Programming for the Web**: Full-stack web development, database integration, and an introduction to Progressive Web Apps (PWAs).
38+
3139
* **Secure Software Architecture**: Foundational security principles, cryptography, and best practices for secure coding.
40+
3241
* **Software Automation**: Machine Learning, Artificial Intelligence, ethical considerations, and impact assessment of automation.
42+
3343
* **Software Engineering Project**: **Project management methodologies, planning, documentation, and the complete system development life cycle.**
3444

3545
## ✨ Key Features
@@ -47,8 +57,11 @@ The content is organized directly according to the NESA syllabus modules.
4757
We welcome contributions from **educators, students, and developers** to help refine and expand this vital resource!
4858

4959
**We Need Your Help With:**
60+
5061
* **Content Review**: Verifying accuracy, adding more in-depth examples, and creating new exercises.
62+
5163
* **Technical Enhancements**: Improving site features, accessibility, and performance optimization.
64+
5265
* **Community Support**: Reporting bugs, providing feedback, and spreading the word.
5366

5467
To get started, please read our comprehensive **[Contributing Guide](CONTRIBUTING.md)** for detailed instructions on setup, content standards, and workflow.
@@ -60,7 +73,9 @@ This project is open source and available under the **[MIT License](LICENSE)**.
6073
We extend our sincere thanks to the following:
6174

6275
* **NSW Education Standards Authority (NESA)** for providing the comprehensive Software Engineering syllabus.
76+
6377
* **The open-source community** for excellent tools and libraries, especially **MkDocs** and **Material for MkDocs**.
78+
6479
* **All contributors and educators** who provide ongoing feedback and improvements.
6580

6681
## Share This Resource!

docs/Year12/SoftwareEngineeringProject/Chapter-26-Testing-and-evaluating/26-01-Testing-methodologies-and-optimisation/index.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -845,8 +845,11 @@ Components of effective test cases:
845845
**Acceptance Test Criteria**:
846846

847847
- Directly tied to user stories and requirements
848+
848849
- Written in business language, not technical terms
850+
849851
- Testable and measurable outcomes
852+
850853
- Clear pass/fail criteria
851854

852855
///
@@ -1076,25 +1079,37 @@ Both automated and manual testing serve important roles in a comprehensive testi
10761079
**Automated Testing - Best For**:
10771080

10781081
- **Regression testing**: Re-running tests after code changes
1082+
10791083
- **Performance testing**: Load and stress testing scenarios
1084+
10801085
- **Repetitive tests**: Tests that need frequent execution
1086+
10811087
- **Data-driven testing**: Testing with large datasets
1088+
10821089
- **Continuous integration**: Tests that run with every build
10831090

10841091
**Manual Testing - Best For**:
10851092

10861093
- **Exploratory testing**: Discovering unexpected issues
1094+
10871095
- **Usability testing**: Evaluating user experience
1096+
10881097
- **Ad-hoc testing**: Unstructured investigation
1098+
10891099
- **Initial test creation**: Developing new test scenarios
1100+
10901101
- **Complex scenarios**: Tests requiring human judgment
10911102

10921103
**Decision Factors**:
10931104

10941105
- Test frequency and repetition requirements
1106+
10951107
- Complexity of test scenarios
1108+
10961109
- Available resources and timeline
1110+
10971111
- Return on investment for automation
1112+
10981113
- Type of functionality being tested
10991114
///
11001115

docs/code-editor/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
11
---
22
title: Python Code Editor
33
hide:
4+
45
- navigation
6+
57
- toc
8+
69
- footer
710
template: main.html
811
---

0 commit comments

Comments
 (0)