From 5878b7cdcdd74b5936ba81d59e28fa154f82724b Mon Sep 17 00:00:00 2001 From: aman333nolawz Date: Sat, 4 Apr 2026 02:18:34 +0530 Subject: Added contribution guide to footer --- src/pages/_contribute.mdx | 101 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 src/pages/_contribute.mdx (limited to 'src/pages/_contribute.mdx') diff --git a/src/pages/_contribute.mdx b/src/pages/_contribute.mdx new file mode 100644 index 0000000..fe326b9 --- /dev/null +++ b/src/pages/_contribute.mdx @@ -0,0 +1,101 @@ +# Contribution Guide + +Welcome! We're thrilled that you're interested in contributing to the [FOSSCET website](https://fosscet.codeberg.page). This site is built by the community, for the community. Whether you want to add your member profile, write a blog post, document an event, or improve the codebase, this guide will help you get started. + +--- + +## Local Development Setup + +To preview your changes locally before submitting them, you'll need to set up the project on your machine. + +You will need either [Node.js](https://nodejs.org/en) and [pnpm](https://pnpm.io), OR [bun](https://bun.sh) installed. + +### 1. Clone the repository + +```bash +git clone https://codeberg.org/fosscet/website-src +cd website-src +pnpm i # or: bun install +``` + +### 2. Start the development server + +```bash +pnpm run dev # or: bun run dev +``` + +### 3. Build the site (Optional) + +To verify that your changes build correctly for production: + +```bash +pnpm run build # or: bun run build +``` + +--- + +## Design & Styling + +For UI contributions or brand assets, please check our [Assets and Style Guide](/styleguide). It contains our official logos, typography, and color scheme + +--- + +## Adding Your Member Profile + +Here is how you can add your very own member card. + +1. Create a markdown file named `.md` in the `src/content/members/` directory. + _(Example: If you want your handle to be `nik`, create `src/content/members/nik.md`)_ +2. To upload an avatar, put the image in `./public/images/myavatar.png`, and fill the form like so: `avatar: /public/images/myavatar.png`. +3. Add your details using the frontmatter format below, followed by a longer bio if you'd like! + +### Member Card Template + +Everything except `name` and `avatar` is optional. + +```markdown +--- +name: +pronouns: +avatar: +bio: +website: +github: +codeberg: +linkedin: +instagram: +mail: +--- + +Detailed bio text goes here. This is a great space to introduce yourself, talk about your favorite FOSS projects, or share your tech stack! This section can be considerably longer than the short `bio` field above. +``` + +--- + +## Writing a Blog Post + +Got an opinion piece, a tutorial, or a FOSS experience to share? We welcome blog contributions! + +1. Create a new file `your-post-title.md` (or `.mdx`) in `src/content/blog/`. +2. Check out `src/content/blog/shortening-of-the-way/index.mdx` for a comprehensive example of the required frontmatter and formatting. +3. **Important:** Remember to remove `draft: true` from your frontmatter when you are ready to publish! + +--- + +## Documenting an Event + +1. Create a new file `event-name.md` (or `.mdx`) in `src/content/events/` +2. Refer to the sample in `src/content/events/event_zero.mdx` for more info + +--- + +## Creating a New Form + +Need to spin up a registration or feedback form? + +1. Create a file `my-form-id.md` in `src/content/forms/`. +2. See the sample at `src/content/forms/test.mdx` for the form configuration schema. + +--- + +_Thank you for contributing to FOSSCET! Every commit helps build a better, more open community._ -- cgit v1.2.3