add: contributing guide

Closes #1

Author: carsakiller

docs/CONTRIBUTING-WIKI.md

@@ -0,0 +1,25 @@
+# Contributing to the Wiki
+
+The content of the wiki articles is stored in `src/content/wiki` in [MDX](https://mdxjs.com/) files. MDX allows us to use components in Markdown.
+
+The various components available for use can be found in [`src/components/common`](../src/components/common/) and [`src/components/wiki`](../src/components/wiki/). Make sure to check out their `README` files to learn more about the components.
+
+## Article Frontmatter
+
+All wiki articles can contain frontmatter at the top of the file.
+
+|    Property     |    Type    | Required | Descripion                                                                                                                  |
+| :-------------: | :--------: | :------: | --------------------------------------------------------------------------------------------------------------------------- |
+|      title      |  `string`  |    ✅    | Display title of the article.                                                                                               |
+|   description   |  `string`  |    ✅    | Short summary of the article.                                                                                               |
+|      tags       | `string[]` |    ❌    | Keywords used in the site search to match this article.                                                                     |
+| getting-started | `boolean`  |    ❌    | Whether or not the article should appear in the "Get Started" section on the wiki index.                                    |
+|   incomplete    | `boolean`  |    ❌    | Mark this article as unfinished. A [`Remark`](../src/components/common/Remark.astro) will appear at the top of the article. |
+
+```mdx
+---
+title: myArticleTitle
+description: Wow, my own article, cool!
+incomplete: true
+---
+```

docs/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing Guide
+
+Hello! Thank you for taking an interest in helping us improve! This document serves to help you learn how to contribute to the project.
+
+See ["Contributing to the Wiki"](./CONTRIBUTING-WIKI.md).
+
+# Contribution Types
+
+We appreciate all contributions, whether you want to add a feature, add documentation to the wiki, fix a typo, or just get involved in the conversation in [issues](https://github/LuaLS/website/issues) and [discussions](https://github.com/LuaLS/website/discussions).
+
+Here are some great ways to get involved:
+
+- Create an issue
+  - Report unexpected behaviour with the site.
+  - Report old, confusing, or incorrect documentation.
+
+- Create a discussion
+  - Chat about more general topics that aren't really an "issue".
+  - Share your ideas.
+
+- Assist with existing issues
+  - Find [issues needing help](https://github.com/LuaLS/website/labels/help%20wanted) and [issues for new contributors](https://github.com/LuaLS/website/contribute).
+
+- Create a pull request
+  - Quickly fix typos and bad links.
+  - [Add content to the wiki](./CONTRIBUTING-WIKI.md)
+
+> **Note**
+> If you are unsure which medium is best for expressing your idea or concern, start with an issue.

src/components/layout/Footer.astro

@@ -22,6 +22,9 @@ const { class: className } = Astro.props;
       <li>
         <a href="/wiki/developing">Development guide</a>
       </li>
+      <li>
+        <ExternalLink url="https://github.com/LuaLS/website/blob/main/docs/CONTRIBUTING.md">Wiki</ExternalLink>
+      </li>
       <li>
         <a href="/wiki/translations#contributing">Translate</a>
       </li>

src/pages/wiki/index.astro

@@ -4,6 +4,7 @@ import Icon from "~/components/common/Icon.astro";
 import Layout from "~/layouts/Main.astro";
 import Tooltip from "~/components/common/Tooltip.astro";
 import fetch from "~/util/fetch";
+import ExternalLink from "~/components/common/ExternalLink.astro";
 
 const CONTRIBUTOR_COUNT = 30;
 
@@ -81,6 +82,12 @@ const contributors = (await response.json()) as Contributor[];
             group="solid"
             color="red"
           />
+          <br />
+          <ExternalLink
+            url="https://github.com/LuaLS/website/blob/main/docs/CONTRIBUTING.md"
+          >
+            Contribute today!
+          </ExternalLink>
         </p>
         <div class="flex">
           {