diff --git a/README.md b/README.md index 8f93f712..5328c130 100644 --- a/README.md +++ b/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 diff --git a/data/projects/README.md b/data/projects/README.md index f7c9ad39..a30568c1 100644 --- a/data/projects/README.md +++ b/data/projects/README.md @@ -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 ![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.