Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #172

Merged
merged 6 commits into from
Jun 28, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,23 @@ Enhancing Ethereum through cryptographic research and collective experimentation
## Contributing guidelines

### Open for contribution.
- For updating project detail, please open PR and request at least two reviewers for approval (there should be auto-assign actions, so you don't need to select manually).
- For adding new features, please open PR and first merge to staging/dev for QA, or open issue for suggestion, bug report.
- For any misc. update such as typo, PR to main and two approval is needed.

### Add/Edit project list
- For updating/adding project detail [you can follow this guide](https://github.com/privacy-scaling-explorations/pse.dev/blob/main/data/projects/README.md)

### Project detail now supports markdown
For PSE members who wish to add more information to the project detail, you can now add to the "description" in the {project}.ts.
## PR Review process
#### For internal, PSE member:
- Suggest to tag: @kalidiagne, @ChialiT, @AtHeartEngineer, @kichong for PR review.
- If question, please reach out in discord channel #website-pse

Supported format:
- Headings
- Table
- more to come in a later release.

Please note the keyword and theme is curated by the comms & design team. If you wish to change, please create a PR.
#### For external:
- Translation PR: please tag a member you know that can help review your translation
- Any type of PR: please state clear your intention
For any suggestion, feel free to open issue or send us a message on Discord #suggestion



## Run Locally
Expand Down
41 changes: 33 additions & 8 deletions data/projects/README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,16 @@
## Add new project to projects list

1. Add new file inside `[...]/data/projects` folder
2. Add project details inside the file already created, to easily include all the required parameters make sure to use the `ProjectInterface`
#### 1. Create a New Project File:
- Navigate to the [...]/data/projects folder within your project directory.
- Inside this folder, create a new file named [project_name].ts.

#### 2. Add Project Details:
- Open the newly created [project_name].ts file.
- To ensure all necessary parameters are included, use the ProjectInterface template. Here's a basic structure to get you started:

```js
export const example: ProjectInterface = {
id: "example",
export const project_name: ProjectInterface = {
id: "project_name",
image: "",
name: "This is an example of the project",
tags: {
Expand All @@ -17,7 +22,22 @@ export const example: ProjectInterface = {
}
```

3. Include the exported constant of the project in `projects.ts` and add it to the array `projects` in that file.
- Fill in the id, image, name, and tags fields as per your project's details. The tags object includes arrays for keywords, themes, types, and builtWith.

#### 3. Register the New Project:
- Open the projects.ts file located in the same directory or wherever your project's list is maintained.
- Add your new project to the projects array to make it visible:

```js
import { project_name } from './projects/[project_name].ts';

const projects: ProjectInterface[] = [
// other projects
project_name,
];
```

By following these steps, you will successfully add a new project and ensure it is correctly registered and visible.

## Show badges in the project card

Expand Down Expand Up @@ -78,7 +98,12 @@ This is the result

![Project links](/public/project/example-project-extra-link.png)

## Markdown supported
### Project detail now supports markdown
For PSE members who wish to add more information to the project detail, you can now add to the "description" in the {project}.ts.

Supported format:
- Headings
- Table
- more to come in a later release.

You can also format the description to your liking using markdown. We supported all the heading, bold and table.
This can help the reader to quickly scan through the important information.
Please note the keyword and theme is curated by the comms & design team. If you wish to change, please create a PR.