Skip to content

Commit c31b4f4

Browse files
Peter JohnsonPeter Johnson
authored andcommitted
readme-update
1 parent 97bb982 commit c31b4f4

1 file changed

Lines changed: 10 additions & 6 deletions

File tree

readme.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
# Evaluation Function Template Repository
2-
hi this is me
2+
33
This template repository contains the boilerplate code needed in order to create an AWS Lambda function that can be written by any tutor to grade a response area in any way they like.
44

55
This version is specifically for python, however the ultimate goal is to make similar boilerplate repositories in any language, allowing tutors the freedom to code in what they feel most comfortable with.
66

77
## Table of Contents
8+
89
- [Evaluation Function Template Repository](#evaluation-function-template-repository)
910
- [Table of Contents](#table-of-contents)
1011
- [Repository Structure](#repository-structure)
@@ -48,14 +49,15 @@ config.json # Specify the name of the evaluation function in this file
4849
- [Production API Gateway Integrations](https://eu-west-2.console.aws.amazon.com/apigateway/main/develop/integrations/attach?api=cttolq2oph&integration=qpbgva8&region=eu-west-2&routes=0xsoy4q)
4950

5051
4. Merge commits into the default branch
52+
5153
- This will trigger the `test-and-deploy.yml` workflow, which will build the docker image, push it to a shared ECR repository, then call the backend `grading-function/ensure` route to build the necessary infrastructure to make the function available from the client app.
5254

5355
5. You are now ready to start developing your function:
54-
56+
5557
- Edit the `app/evaluation.py` file, which ultimately gets called when the function is given the `eval` command
5658
- Edit the `app/evaluation_tests.py` file to add tests which get run:
57-
- Every time you commit to this repo, before the image is built and deployed
58-
- Whenever the `healthcheck` command is supplied to the deployed function
59+
- Every time you commit to this repo, before the image is built and deployed
60+
- Whenever the `healthcheck` command is supplied to the deployed function
5961
- Edit the `app/docs.md` file to reflect your changes. This file is baked into the function's image, and is made available using the `docs` command. This feature is used to display this function's documentation on our [Documentation](https://lambda-feedback.github.io/Documentation/) website once it's been hooked up!
6062

6163
---
@@ -71,18 +73,21 @@ The grading scripts are hosted AWS Lambda, using containers to run a docker imag
7173
Images are run within **containers** on AWS, which give us a lot of flexibility over what programming language and packages/libraries can be used. For more information on Docker, read this [introduction to containerisation](https://www.freecodecamp.org/news/a-beginner-friendly-introduction-to-containers-vms-and-docker-79a9e3e119b/). To learn more about AWS Lambda, click [here](https://geekflare.com/aws-lambda-for-beginners/).
7274

7375
### Middleware Functions
76+
7477
In order to run the algorithm and schema on AWS Lambda, some middleware functions have been provided to handle, validate and return the data so all you need to worry about is the evaluation script and testing.
7578

7679
The code needed to build the image using all the middleware functions are available in the [BaseEvaluationFunctionLayer](https://github.com/lambda-feedback/BaseEvalutionFunctionLayer) repository.
7780

7881
### GitHub Actions
82+
7983
Whenever a commit is made to the GitHub repository, the new code will go through a pipeline, where it will be tested for syntax errors and code coverage. The pipeline used is called **GitHub Actions** and the scripts for these can be found in `.github/workflows/`.
8084

8185
On top of that, when starting a new evaluation function, you will have to complete a set of unit test scripts, which not only make sure your code is reliable, but also helps you to build a _specification_ for how the code should function before you start programming.
8286

8387
Once the code passes all these tests, it will then be uploaded to AWS and will be deployed and ready to go in only a few minutes.
8488

8589
## Pre-requisites
90+
8691
Although all programming can be done through the GitHub interface, it is recommended you do this locally on your machine. To do this, you must have installed:
8792

8893
- Python 3.8 or higher.
@@ -95,5 +100,4 @@ Copy this template over by clicking **Use this template** button found in the re
95100

96101
## Contact
97102

98-
TBC
99-
=======
103+
# TBC

0 commit comments

Comments
 (0)