-
If you just landed here, and you have no idea what GitHub is, please go to Getting Started.
-
If you have been here before and would like instructions on how to add content, please go to Adding Content.
-
Curious what types of articles we have here? Check out the temporary table of contents.
This repository is here for YOU. The goal is to build an open source set of content to help people like Information Architects, Business Analysts, "Makers" (aka Citizen Developers), and Site Owners who want to use the platform better.
There are lots of other resources for developers, so that isn't our target audience. We may include some code samples or snippets of code in the context of getting something done, but for the most part, any code in this repository will exist to help facilitate conversations between the folks listed above and the developers with whom they work.
If we're successful here, we may be able to drive our content into the official Microsoft documentation, much the way the sp-dev-docs repository does. Be a part of history!
If you are looking for documentation about something which you feel fits this mold but are coming up short, here are some things you can do by raising an Issue in the Issues list:
- Explain what you need and why, but be realistic about the time frames in which you may see a result. This is an open source effort and we all have day jobs.
- Suggest an article or set of articles you've seen in blogs or other electronic formats which you think start(s) to get at the issue and might make a good addition here.
- Write something to fill the gap. Whether it's a germ of an explanation or a full-fledged article, what you write can add value to the repository.
While we want the content in this repository to be extremely useful, it doesn't need to be dry and flavorless. We want to characterize the feel and joy of getting things done well in addition to the mechanics. Specific examples or analogies can be very useful to make this happen.
This repository is sanctioned by Microsoft and therefore there are some contribution guidelines to follow. If you want to contribute directly, you need to have a Github account. But we know not all of you know how to use Github or want to learn. If you have ideas and would like to submit them outside Github, we will be coming up with mechanisms to cover those situations.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.