refactor: smaple all together

JOJ3-Configuration-Schema.md

@@ -77,21 +77,6 @@ It should be saved in the `joj-root` configuration for the repository.
 - put this `repo.toml` file in the "root directory" containing all the configuration for this
  repository, eg. `/home/tt/.config/joj/hw` for homework repository
 
-<details><summary>Sample repo.toml -- stored in the `joj-root` configuration for the repository</summary>
-
-```toml
-teaching_team = ["mac-wang", "jon-lee", "allen_wr"] # jaccounts
-
-maxsize = 5 # 5MB repo max size
-releasetags = ["h1", "h2", "h3"] # list of valid release tags 
-
-[files]
-immutable = [".gitignore", ".gitattributes", ".gitea/workflows/push.yaml"] # readonly files
-required = [ "Changelog.md", "Readme.md" ] # files that must be found
-whitelist.patterns = ["*.cpp", "*.c", "*.m", "*.md", "Makefile", "CMakelist.txt", ".gitea", "messenger.json"] # files/patterns which are not  forbidden
-```
-
-</details>
 
 ## Task level configuration
 
@@ -207,10 +192,57 @@ Not ready yet.
 - `output.ignorespaces [boolean]`: ignore white spaces in diff output (default: `true`)
 - `score [int]`: score awarded for passing the test case (default: `0`)
 
-*Note.* This parser can be configured and adjusted for each test-case (others parsers are configured at the stage level)
+*Note.* This parser can be configured and adjusted for each test-case (others parsers are configured at stage level)
 
 
-<details><summary>Sample task.toml</summary>
+## Examples
+
+
+Sample repository configuration file stored in the `joj-root` configuration for the
+repository.
+
+<details><summary>Sample repo.toml</summary>
+
+```toml
+teaching_team = ["mac-wang", "jon-lee", "allen_wr"] # jaccounts
+
+maxsize = 5 # 5MB repo max size
+releasetags = ["h1", "h2", "h3"] # list of valid release tags 
+
+[files]
+immutable = [".gitignore", ".gitattributes", ".gitea/workflows/push.yaml"] # readonly files
+required = [ "Changelog.md", "Readme.md" ] # files that must be found
+whitelist.patterns = ["*.cpp", "*.c", "*.m", "*.md", "Makefile", "CMakelist.txt", ".gitea", "messenger.json"] # files/patterns which are not  forbidden
+```
+
+</details>
+
+Sample basic task configuration for MATLAB where most default options are used.
+
+<details><summary>Basic sample task.toml</summary>
+
+```toml
+task="hw3 ex5"
+
+release.deadline = 2024-10-18 23:59:00+08:00
+
+[judge-base]
+command="./matlab-joj ./h3/ex5.m"
+files.import = [ "tools/matlab-joj", "tools/matlab_formatter.py" ] 
+score = 100 
+
+parsers = ["diff", "result-detail"]
+result-detail.time = false
+result-detail.mem = false
+result-detail.error = true
+```
+
+</details>
+
+
+Sample advanced task configuration for C where many default options are overwritten.
+
+<details><summary>Advanced sample task.toml</summary>
 
 ```toml
 # general task configuration