From aa78a3e6a4e7c88f027af01a24165faf78273a64 Mon Sep 17 00:00:00 2001 From: skal Date: Mon, 2 Feb 2026 12:29:41 +0100 Subject: docs: Refactor and prioritize project task lists - Restructured PROJECT_CONTEXT.md to introduce a clear roadmap with 'Next Up', 'In Progress', and 'Future Goals'. - Condensed the 'Session Decisions' section into a concise 'Architectural Overview' focusing on the current state. - Updated TODO.md to reflect the highest priority tasks: finalizing the build system and optimizing spectrogram assets. --- TODO.md | 43 +++++++++++++------------------------------ 1 file changed, 13 insertions(+), 30 deletions(-) (limited to 'TODO.md') diff --git a/TODO.md b/TODO.md index e0e6b14..414ff0f 100644 --- a/TODO.md +++ b/TODO.md @@ -1,35 +1,18 @@ -# list of quick TODO tasks +# To-Do List -this is temporary, frequently-updated, list of quick TODO that -don't warrant a 'Task' in itself. -Once done, move the task description to the 'Past Tasks' section +This file tracks the next set of immediate, actionable tasks for the project. +## Next Up -## Up-to-date Tasks list +- **Task #4: Finalize Build System** + - [ ] Implement Linux cross-compilation from macOS. + - [ ] Create `scripts/check_all.sh` to build and test all platform targets (macOS, Windows, Linux) to ensure stability before commits. +- **Task #10: Optimize Spectrogram Assets** + - [ ] Modify `spectool` to trim leading and trailing silent frames from `.spec` files to reduce asset size. -In no particular order, they just need to be done: - - * A) each build_XXX build directory is generating its own build_XXX/src/generated/* assets and code. - This is wrong and error-prone. There should be one source of truth - for the generated assets/data/code at the top of the tree, under a common - src/generated/ directory. Adapt all the code for that. Pay attention - to tests (test_assets, e.g.) that *also* generate assets. They must§ - generate them in a throw-away directory. - - * B) make a pass of 'vertical compaction' for the code: there's a lot of - superfluous '\n' empty lines in the code that shouldn't be here. - Remove them to have a vertically more dense code. Use clang-format if needed. - - * C) add a top-level @README.md file with a short description of the - project for new-comers, a one-line description of each .md files, and - a quick layout and description of the source tree. - - * D) move all the non-essential .md files to a top-level doc/ directory - (or any other more appropriate name) to remove the top-level file - clutter. Keep ony the essential ones at top level. Update the git - repo accordingly. - -## Past Tasks - -The past TODO are already done (stored here for archiving): +## Completed +- Centralize generated files into `src/generated`. +- Vertically compact C++ source code. +- Create top-level `README.md`. +- Move non-essential documentation to `doc/`. \ No newline at end of file -- cgit v1.2.3