Skip to content

Commit

Permalink
feat(setup): update README file and finish repo setup
Browse files Browse the repository at this point in the history
  • Loading branch information
gruvw committed May 8, 2024
1 parent 7a7a27e commit 271fdad
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 29 deletions.
5 changes: 1 addition & 4 deletions .github/workflows/build_pdf.yml
Original file line number Diff line number Diff line change
@@ -1,9 +1,6 @@
name: Build PDF from Markdown

on:
push:
branches:
- main
on: push

jobs:
build:
Expand Down
30 changes: 30 additions & 0 deletions INSTRUCTIONS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
### Description

This repository contains a template for the PRD deliverable for the CS-311: The Software Enterprise (SwEnt) course.
You can find it in the `template` folder.

There is also a sample PRD under `samples/epfl-pocketcampus`; this is for the EPFL Pocketcampus app, which was developed during the very first intantiation of this course. You can use this sample PRD as a reference.

### Instructions

1. Fork this repo into your organization and clone it
```
git clone [email protected]:<your-org-name>/prd.git
cd prd
```

2. Set up Github Actions

This repo includes a workflow called `build_pdf.yml` that uses GitHub Actions to automatically generate a PDF of your PRD.

After cloning this repo, customize the workflow for your own team by editing the workflow as follows:

- Line 40: Set the right team number, by replacing `26` with your team's number [here](.github/workflows/build_pdf.yml#40);
- Line 46: Same for the PDF artifact's name (replace `26` with your team's number) [here](.github/workflows/build_pdf.yml#46).

3. Write your PRD

To produce your own PRD, read the comments in italics, fill out the various sections, then remove the comments.
Use a collaborative workflow (branches, PRs, etc.) within your team to edit the PRD.
Pushing to `main` will generate the PDF.

31 changes: 6 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,11 @@
### Description
# Proxima PRD

This repository contains a template for the PRD deliverable for the CS-311: The Software Enterprise (SwEnt) course.
You can find it in the `template` folder.
This repository contains the Proxima PRD deliverable for the EPFL CS-311: The Software Enterprise (SwEnt) course.

There is also a sample PRD under `samples/epfl-pocketcampus`; this is for the EPFL Pocketcampus app, which was developed during the very first intantiation of this course. You can use this sample PRD as a reference.
You can take a look at the Proxima project here: **https://github.com/ProximaEPFL/proxima**.

### Instructions
**Note**: original instructions on how to use this repository can be found on the [INSTRUCTIONS.md](/INSTRUCTIONS.md) file.

1. Fork this repo into your organization and clone it
```
git clone [email protected]:<your-org-name>/prd.git
cd prd
```

2. Set up Github Actions

This repo includes a workflow called `build_pdf.yml` that uses GitHub Actions to automatically generate a PDF of your PRD.

After cloning this repo, customize the workflow for your own team by editing the workflow as follows:

- Line 40: Set the right team number, by replacing `26` with your team's number [here](.github/workflows/build_pdf.yml#40);
- Line 46: Same for the PDF artifact's name (replace `26` with your team's number) [here](.github/workflows/build_pdf.yml#46).

3. Write your PRD

To produce your own PRD, read the comments in italics, fill out the various sections, then remove the comments.
Use a collaborative workflow (branches, PRs, etc.) within your team to edit the PRD.
Pushing to `main` will generate the PDF.
### Automatic PDF generation

You can find the resulting generated PDF on the associated [GitHub workflow artifact](https://docs.github.com/en/actions/managing-workflow-runs/downloading-workflow-artifacts).

0 comments on commit 271fdad

Please sign in to comment.