# Slide and document templates

## General naming rules

Please when creating documents for Ersilia, abide by the following:

* GitHub repositories: all words in <mark style="color:green;">minus</mark>, linked by a <mark style="color:green;">hypen</mark> (not underscore)
* Documents: document names must be either:
  * Combined words starting with Caps (for example: ErsiliaDocument)
  * Combined words with underscore (for example: ersilia\_document)
* Dated documents: documents for a specific day (for example a presentation given on a conference) must be saved with the date first in the following format: <mark style="color:purple;">YYMMDD</mark> (260102 would be 2nd January, 2026). This keeps things listed in the correct alphabetical order.
* Ordered files: files designed to run in sequence, for example scripts or notebooks, should use <mark style="color:$danger;">zero-padded numbering</mark> so they remain correctly ordered. The names must be combined words with underscore, no points (for example: 01\_ersilia\_script.py or 001\_ersilia\_notebook.ipynb)
* <mark style="color:$warning;">Correspondence</mark> between files and outputs: the outputs (data, plots...) generated by numbered scripts and notebooks should also be numbered. For example, all plots generated by script 03\_plotting.py should be labelled as 03\_plot\_a.png, 03\_plot\_b.png, etc
* Plots: plot names must be combined words (minus) with underscore saved in <mark style="color:orange;">.png</mark> (for presentations) and <mark style="color:orange;">.svg/.pdf</mark> (for papers).

## Slide decks

* Keynote template: all presentations meant for external presentation of Ersilia (partner presentations, conferences, dissemination materials) must be done with Ersilia's Keynote template and shared in .pdf version. The keynote template is available from download from this [link](https://drive.google.com/file/d/1pn8cKsOnubHQdWeJuFVNr06WgY-lQX8T/view?usp=drive_link). Detailed usage instructions are enclosed in the same document.
* Google Drive template: quick presentation set-up for internal meetings and project update meetings. To use it, create a new GSlides document in GDrive, select From a Template and choose the ERSILIA-TEMPLATE-25-GENERAL.

## Documents

* Letterhead document: for official use only, create by selecting GDocs > From a Template and choosing either the LOGO template (letterhead in first page only), Template Footer (Letterhead in footer) or Template Header (letterhead in all pages)
* Project template: for project tracking purposes, select from the GDocs > From a Template.

## Repository templates

Ersilia has three kinds of repository templates, extensively explained in their respective repositories:

* Ersilia Model Template ([eos-template](https://github.com/ersilia-os/eos-template)): template for Ersilia Model Hub Models.
* Ersilia Analysis Repository ([eos-analysis-template](https://github.com/ersilia-os/eos-analysis-template)): template for a scientific project (data analysis, plotting etc)
* Ersilia Python Package ([eos-python-package](https://github.com/ersilia-os/eos-python-package)): template to build a python package following Ersilia's structure.