mirror of
https://github.com/privacy-scaling-explorations/pse.dev.git
synced 2026-04-23 03:01:03 -04:00
Merge pull request #172 from privacy-scaling-explorations/kalidiagne-patch-1
Update README.md
This commit is contained in:
19
README.md
19
README.md
@@ -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
|
||||
|
||||
@@ -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: {
|
||||
@@ -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
|
||||
|
||||
@@ -78,7 +98,12 @@ This is the result
|
||||
|
||||

|
||||
|
||||
## 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.
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user