rename docs dir

docs-old/index.md

@@ -0,0 +1,48 @@
+# DCR Documentation
+
+DCR is a lightweight build tool for C/C++ projects with a Cargo-like workflow.
+
+## Quick Start
+
+```sh
+dcr new hello
+cd hello
+dcr run
+```
+
+## Configuration
+
+Project configuration lives in `dcr.toml`.
+See `docs/dcr-toml.md` for the full schema and examples.
+
+## Build Flags
+
+You can add custom compile and link flags in `[build]`:
+
+```toml
+[build]
+compiler = "gcc"
+standard = "c99"
+kind = "bin"
+target = "./dist"
+cflags = ["-D_POSIX_C_SOURCE=200809L", "-Wall", "-Wextra", "-O2", "-Ilib/frecli"]
+ldflags = ["-Llib/frecli", "-lfrecli", "-lm"]
+```
+
+## Dependencies
+
+Path dependencies can be declared in `[dependencies]` and are resolved on build.
+
+```toml
+[dependencies]
+frecli = { path = "./lib/frecli", include = ["."], lib = ["."], libs = ["frecli"] }
+```
+
+## Source Discovery
+
+DCR compiles all `.c`/`.cpp` files under `src/` recursively. The file containing `main()` can be in any subdirectory.
+
+## Notes
+
+- `dcr run` works only for `kind = "bin"`.
+- Incremental rebuild currently tracks source file changes only (`.c/.cpp`).