Skip to content

Home

Jump to bottom
Luise Freese edited this page Jul 25, 2022 · 17 revisions

Welcome to the Microsoft 365 Community Blog wiki!

This area covers topics related to creating content in the community blog. We'll add more content as we evolve this blog, but here is what we have so far:

Preparing for your post

We are looking for blog posts focusing on how to extend Microsoft 365 with custom-coded and low-code ways. Our audience spans a broad variety of developers and makers and we aim to empower them to build more with Microsoft 365. To prepare your post, it's a good idea to think about:

  • Who are you writing this for?
  • What is the use case/scenario for your solution?
  • Does your approach contain a sample/pattern, that is potentially reusable? Can you include it?

Once you covered this, you can think about everything that will make it easier for people to comprehend your work:

  • Overview-diagram that shows how different parts fit together
  • Sample code
  • Example

Writing your post

This blog is backed by a GitHub repository and all contributions are done by Pull requests.

Extensive guidance on how contributing works

If you feel like you need some more support with that, you can

  • Read the full Contributing guide (with step-bt-step instructions)
  • Sign up for our Sharing is Caring sessions, where we provide you with hands-on guidance on how to use GitHub, submit samples, contribute to documentation and more.

tl;dr - how-to guidance for experienced GitHub users

If you are already familiar with GitHub, please follow this high-level overview:

  • Fork this repository https://github.com/pnp/blog
  • Create a new branch that matches the article name that you want to write
  • In the content/post folder, create your own folder (you may use the title of your post as the name of the folder, use - (dash) instead of (space))
  • In the newly created folder add an index.md file with your article
  • Insert metadata at the top of this file and adjust with your values:
---
# this is the title
title: "this is the title of your blog post"
# this is the publishing date of your article, usually this should match "now"
date: 2022-04-25T08:40:00-04:00
# This is your name
author: "your Name"
# This is your GitHub name
githubname: yourGitHubUserName
# Don't change
categories: ["Community post"]
# Link to the thumbnail image for the post
images:
- images/myImage.png
# don't change
tags: []
# don't change
type: "regular"
draft: true
---
  • Create a new folder images in your article’s folder. In the images folder you may save any image/graphic which may be used in your article

Publishing your post

  • Pull request your changes, targeting the main branch
  • A maintainer will review, so that your article is published soon

If there are only minor changes necessary, like formatting or obvious typos, we will apply them and publish. In case there is some more extensive work to do still, a maintainer will request changes and help you resolve any issue.

Run Hugo locally

We also provide you with guidance on How to run Hugo locally - Special thanks to Adam | @Adam25858782 for writing these!

Guidance on formatting and how to write good instructions

We collected some resources to improve your writing style

Clone this wiki locally