diff --git a/docs/getting_started/introduction.md b/docs/getting_started/introduction.md index 5b442ac..6d3695a 100644 --- a/docs/getting_started/introduction.md +++ b/docs/getting_started/introduction.md @@ -1,11 +1,5 @@ # Introduction -## About - -Key4hep is a turnkey software stack for detector optimisation and performance studies for future collider experiments. It provides common libraries and solutions for the generation, simulation, reconstruction, and analysis of events at future colliders, with a strong focus on coherence and re-usability in order to reduce duplication of effort and foster collaboration. Key4hep serves as a common software base for future experiments, allowing project-specific adaptations to be made to accommodate their specific requirements. - -Key4hep is a community-driven project, with contributions and adaptations from different -future collider projects: CEPC, CLIC, EIC, FCC, ILC, Muon Collider. ## Notable stack components @@ -30,15 +24,3 @@ Key4hep draws significant inspiration from iLCSoft, a common software stack wide ### Infrastructure Key4hep uses the Spack package manager to manage the compilation and deployment of its packages. Spack allows experiments to share build recipes, enabling any experiment to build the stack independently or extend it for their own needs. In addition, the Key4hep stack is also built centrally and deployed to the CVMFS, from where it can be [easily accessed](setup.md). - -## License - -Except where otherwise noted, the example programs and other software provided -by Key4hep are made available under the [OSI](https://opensource.org)-approved [Apache -2.0](https://opensource.org/license/apache-2-0/). - -## Acknowledgements -Strategic R&D Programme on Technologies for Future Experiments ([CERN-OPEN-2018-006](https://cds.cern.ch/record/2649646/)) https://ep-rnd.web.cern.ch/ - -European Union’s Horizon 2020 Research and Innovation programme under Grant -Agreement no. 101004761. \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 3374ac3..0cf9abe 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,38 +1,109 @@ # Key4hep +Key4hep is a turnkey software stack for detector optimisation and performance studies for future collider experiments. It provides common libraries and solutions for the generation, simulation, reconstruction, and analysis of events at future colliders, with a strong focus on coherence and re-usability in order to reduce duplication of effort and foster collaboration. + +## Key Goals +Key4hep aims to: +- **Unify software development** across future collider experiments by providing a common foundation +- **Reduce duplication of effort** through shared libraries and standardized interfaces +- **Enable detector optimization** with comprehensive simulation and reconstruction tools +- **Foster collaboration** between different experimental communities +- **Provide turnkey solutions** that work out-of-the-box for common physics tasks +- **Maintain coherence** across the software stack while allowing experiment-specific customizations +- **Prefer reusing existing solutions** where possible and avoid re-inventing the wheel + +## Community and Contributors +Key4hep is a community-driven project that brings together software developers and physicists from multiple future collider experiments. The project benefits from active contributions and adaptations from: +- **FCC** (Future Circular Collider) +- **ILC** (International Linear Collider) +- **CLIC** (Compact Linear Collider) +- **CEPC** (Circular Electron Positron Collider) +- **EIC** (Electron-Ion Collider) +- **Muon Collider** + +## Quick Start +New to Key4hep? Start here: +- **[Introduction](getting_started/introduction.md)** - Learn about Key4hep's goals and architecture +- **[Getting Key4hep](getting_started/setup.md)** - Learn how and where Key4hep is available +- **[Getting Help](getting_started/help.md)** - Find support and community resources + +Want to contribute? Look at our **[Contribution Guide](getting_started/CONTRIBUTING.md)**. The majority of Key4hep related repositories is hosted in the [key4hep github organization](https://github.com/key4hep). + +## Main Documentation Sections +- **[How-to Guides](how-tos/README.md)** - Step-by-step instructions for common tasks +- **[Tutorials](tutorials/README.md)** - Learn Key4hep through hands-on examples +- **[Developer Documentation](developing-key4hep-software/README.md)** - Contribute to and extend Key4hep +- **[Build Instructions](spack-build-instructions-for-librarians/README.md)** - Advanced build and deployment guides + +## License +Except where otherwise noted, the example programs and other software provided +by Key4hep are made available under the [OSI](https://opensource.org)-approved [Apache +2.0](https://opensource.org/license/apache-2-0/). + +## Acknowledgements + +Strategic R&D Programme on Technologies for Future Experiments ([CERN-OPEN-2018-006](https://cds.cern.ch/record/2649646/)). See also [the EP R&D webpage](https://ep-dep.web.cern.ch/rd-experimental-technologies). + +European Union's Horizon 2020 Research and Innovation programme under Grant Agreement no. 101004761. ```{eval-rst} .. toctree:: :maxdepth: 2 - :caption: Getting started + :caption: Getting Started + :hidden: getting_started/introduction.md - getting_started/help.md getting_started/setup.md + getting_started/help.md getting_started/CONTRIBUTING.md - .. toctree:: :maxdepth: 3 - :includehidden: - :caption: Contents + :caption: User Guides + :titlesonly: + :hidden: how-tos/README.md tutorials/README.md + +.. toctree:: + :maxdepth: 3 + :caption: Developer Resources + :titlesonly: + :hidden: + developing-key4hep-software/README.md spack-build-instructions-for-librarians/README.md + +.. toctree:: + :maxdepth: 2 + :caption: More Information + :titlesonly: + :hidden: + talks-and-presentations/README.md call-for-logos/README.md .. toctree:: :maxdepth: 2 - :includehidden: - :caption: External links + :caption: Community Resources + :titlesonly: + :hidden: FCC software CLIC software ILC software CEPC software Muon Collider software -``` +.. toctree:: + :maxdepth: 1 + :caption: External Resources + :titlesonly: + :hidden: + + EDM4hep + podio + Gaudi (doxygen) + Acts +```