1
Fork 0

docs: cleanup and extra references

This commit is contained in:
Tibo De Peuter 2026-05-20 15:00:50 +02:00
parent 511c3ebd95
commit f569f4c008
5 changed files with 14 additions and 3 deletions

View file

@ -9,6 +9,7 @@ For the core codebase, scripts, and contribution history, visit our [GitHub Repo
- **[Installation Instructions](./DEVELOPMENT.md)**: Steps to set up your development environment locally or in a devcontainer using `uv`, including GPU configuration. For High-Performance Computing (HPC) setup details, see the **[HPC Guide](./HPC.md)**.
- **[How to Run Experiments](./api/training.md)**: A complete guide on running training jobs, setting custom hyperparameters, and overriding config options using Hydra.
- **[Results & Reproduction](./api/reproduction.md)**: Guide on how to access our public WandB training runs table and reproduce our training and evaluation phases (determining the best checkpoint vs. comparing architectures).
- **[Contribution Guidelines](./CONTRIBUTING.md)**: Standards, rules, and best practices for developing and adding code to the repository.
- **[Repository Structure](#repository-structure)**: Overview of the directories and files within the codebase.
## Repository Structure

View file

@ -54,3 +54,7 @@ python scripts/evaluate_checkpoints.py \
```
This script scans the `checkpoints/` directory of the specified run and evaluates every `.flax` file it finds using the model's training morphology.
---
For a step-by-step walkthrough on using these evaluation phases to reproduce our project results, see the **[Results & Reproduction Guide](./reproduction.md)**.

View file

@ -58,3 +58,7 @@ uv run python scripts/analysis/explore_tensorboard.py runs/your_run_name/
```
See the detailed description in [`/scripts/analysis/README.md`](../../scripts/analysis/README.md).
## Developer Logging API
For details on the developer API of our internal logging library (how backend routing, checkpoint synchronization, and singleton initialization works), see the **[Experiment Logger API Guide](../../src/experiment_logger/README.md)**.

View file

@ -6,6 +6,8 @@ This guide covers how to configure and run training experiments for the Brittle
The project uses a modular configuration system powered by [Hydra](https://hydra.cc/). Instead of passing many command-line flags, you select and override configuration groups.
For a detailed guide on the structure, validation, and usage of our Hydra configuration files, see the **[Brittle Star Configuration System Guide](../../configs/README.md)**.
### Creating a Custom Experiment
1. **Create a new experiment file:**