# Promoting Open Science in Learning Analytics: An Interactive Tutorial on Licensing, Data, and Containers
[![OSF][badge]][osf]
*Promoting Open Science in Learning Analytics: An Interactive Tutorial on Licensing, Data, and Containers* is a tutorial to be presented at the [*14th International Conference on Learning Analytics and Knowledge*][lak].
This project serves as the repository holding the webpage. The rendered version can be viewed at https://lak2024-tutorial.howtoopenscience.com.
## License
The content of this Open Science Foundation project under the [Creative Commons Attribute 4.0 International License][cc4].
## Local Setup
### [Docker][docker] Container
Clone this repository and run the following commands:
```
docker build -t <image_name> .
docker run --rm -it -p 8000:8000 -v ${PWD}/src:/docs <image_name>
```
`image_name` can be specified to whatever identifier the user desires. This will run the docs server and expose it to the local host on port 8000.
### Python
This setup runs in Python 3.9.5. You can install the required libraries through the provided `requirements.txt`:
```
pip install -r requirements.txt
```
Then navigate to the `src` folder in your terminal and serve the docs.
```
cd ./src
mkdocs serve
```
> You may need to prefix the `pip` or `mkdocs` command with either `python3 -m` for Unix systems or `py -m` for Windows systems if the python modules were not properly installed onto the path.
## Citation
```
@misc{Haim_Hutt_Shaw_Heffernan_2023,
title={Promoting Open Science in Learning Analytics: An Interactive Tutorial on Licensing, Data, and Containers},
url={osf.io/kja8r},
publisher={OSF},
author={Haim, Aaron and Hutt, Stephen and Shaw, Stacy T and Heffernan, Neil T, III},
year={2023},
month={Nov}
}
```
[badge]: https://img.shields.io/badge/OSF-10.17605%2Fosf.io%2Fkja8r-blue
[osf]: https://doi.org/10.17605/osf.io/kja8r
[lak]: https://www.solaresearch.org/events/lak/lak24/
[cc4]: https://osf.io/jrw39
[docker]: https://www.docker.com/
