forked from swent-epfl/prd
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(setup): update README file and finish repo setup
- Loading branch information
Showing
3 changed files
with
37 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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: | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |