guest blog post

Author: psjamesp

.github/ISSUE_TEMPLATE/guest-blog-post.yml

@@ -0,0 +1,72 @@
+name: Guest Blog Post Submission
+description: Pitch or submit a guest blog post for powershell.org
+title: "[Article] "
+labels: ["guest-post", "article"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your interest in writing for PowerShell.org!
+
+        You can either **pitch an idea** here or **submit a full draft**. If you're comfortable with Git, you can also submit a pull request directly — see our [CONTRIBUTING.md](https://github.com/PowerShellOrg/PowerShellOrgWebsite/blob/main/CONTRIBUTING.md) for instructions.
+
+  - type: input
+    id: title
+    attributes:
+      label: Article Title
+      placeholder: "e.g., Getting Started with PSReadLine Predictive IntelliSense"
+    validations:
+      required: true
+
+  - type: input
+    id: author_name
+    attributes:
+      label: Author Name
+      placeholder: "Your name as you'd like it displayed"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: submission_type
+    attributes:
+      label: Submission Type
+      options:
+        - "Pitch — I'd like feedback before writing"
+        - "Draft — Full article included below"
+    validations:
+      required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary / Pitch
+      placeholder: "What's the article about? Who is the target audience? (2-3 sentences)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: article_content
+    attributes:
+      label: Article Content (Markdown)
+      description: "Paste your full article in Markdown if submitting a draft. Leave blank if pitching."
+      render: markdown
+    validations:
+      required: false
+
+  - type: input
+    id: author_url
+    attributes:
+      label: Author Website or Social Link (optional)
+      placeholder: "https://twitter.com/yourhandle or https://yourblog.com"
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Submission Agreement
+      options:
+        - label: "This is my original work and I grant PowerShell.org permission to publish it."
+          required: true
+        - label: "I understand the article may be edited for clarity and formatting."
+          required: true

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing to PowerShell.org
+
+Thanks for your interest in contributing! There are two main ways to contribute content.
+
+## Submitting a Guest Blog Post
+
+### Option A: Submit via GitHub Issue (easiest)
+
+If you're not comfortable with Git, you can pitch or submit your article through our issue template:
+
+1. Go to [New Issue](https://github.com/PowerShellOrg/PowerShellOrgWebsite/issues/new?template=guest-blog-post.yml)
+2. Fill out the form with your article title, summary, and content
+3. A maintainer will review and publish it
+
+### Option B: Submit via Pull Request
+
+1. Fork this repository
+2. Create a new branch for your article
+3. Add your article as a Markdown file in `content/articles/` using this naming convention:
+
+   ```
+   content/articles/YYYY-MM-DD-your-article-slug.md
+   ```
+
+4. Use this front matter template:
+
+   ```yaml
+   ---
+   title: "Your Article Title"
+   author: Your Name
+   authors:
+     - Your Name
+   date: "YYYY-MM-DDT00:00:00+00:00"
+   categories:
+     - Category Name
+   tags:
+     - tag1
+     - tag2
+   ---
+
+   Your article content in Markdown goes here.
+   ```
+
+5. Submit a pull request with a brief description of your article
+
+### Writing Tips
+
+- Write in Markdown
+- Use fenced code blocks with language hints (e.g., ` ```powershell `) for code samples
+- Keep titles concise and descriptive
+- Include a brief intro that tells readers what they'll learn
+- Test any code examples before submitting
+
+## Submitting a Community Event
+
+Add your PowerShell-related event to our community calendar:
+
+1. Go to [New Event](https://github.com/PowerShellOrg/PowerShellOrgWebsite/issues/new?template=community-event.yml)
+2. Fill out the event details
+3. A maintainer will add it to the calendar
+
+## Reporting Issues
+
+Found a bug or broken link? [Open an issue](https://github.com/PowerShellOrg/PowerShellOrgWebsite/issues/new) and let us know.
+
+## Code of Conduct
+
+Be kind, be helpful, be respectful. We're all here because we love PowerShell.