Before you begin:
- Have you read the code of conduct?
- Check out the existing issues & see if we accept contributions for your type of issue.
Navigating a new codebase can be challenging, so we're making that a little easier. As you're using this MicroStrategy Embedding SDK Docs, you may come across an article that you want to make an update to. You can find and click the Edit button on the top right corner on that article, which will take you to the file in this repo where you'll make your changes.
Before you make your changes, check to see if an issue exists already for the change you want to make.
If you spot something new, open an issue here. We'll use the issue to have a conversation about the problem you want to fix.
Fork using the command line:
- Fork the repo so that you can make your changes without affecting the original project until you're ready to merge them.
Fork using GitHub Desktop:
- Getting started with GitHub Desktop will guide you through setting up Desktop.
- Once Desktop is set up, you can use it to fork the repo!
Make your changes to the file(s) you'd like to update. Here are some tips and tricks for using the docs codebase.
- Are you making changes to the application code? You'll need Node.js v16 to run the site locally. See contributing/development.md.
- Are you contributing to markdown? We use Markdown.
When you're done making changes and you'd like to propose them for review, use the pull request template to open your PR (pull request).
- Once you submit your PR, others from the Docs community will review it with you. The first thing you're going to want to do is a self review.
- After that, we may have questions, check back on your PR to keep up with the conversation.
Congratulations! The whole MicroStrategy community thanks you. ✨
Once your PR is merged, you will be proudly listed as a contributor in the contributor chart and at the bottom of the page you contributed to.
Now that you're a part of the MicroStrategy Docs community, you can keep participating in many ways.
Learn more about contributing:
You can contribute to the MicroStrategy Embedding SDK Docs content and site in several ways. This repo is a place to discuss and collaborate on MicroStrategy Embedding SDK Docs! Our small, but mighty 💪 docs team is maintaining this repo, to preserve our bandwidth, off topic conversations will be closed.
If you've found something in the content or the website that should be updated, search open issues to see if someone else has reported the same thing. If it's something new, open an issue here. We'll use the issue to have a conversation about the problem you want to fix.
A pull request is a way to suggest changes in our repository.
When we merge those changes, they should be deployed to the live site within 24 hours. 🌍 To learn more about opening a pull request in this repo, see Opening a pull request below.
We are a small team working hard to keep up with the documentation demands of a continuously changing product. Unfortunately, we just can't help with support questions in this repository. If you are experiencing a problem with MicroStrategy, unrelated to our documentation, please contact MicroStrategy Support directly. Any issues, or pull requests opened here requesting support will be given information about how to contact MicroStrategy Support, then closed and locked.
This website is internationalized and available in multiple languages. The source content in this repository is written in English. We integrate with an external localization platform and work with professional translators to localize the English content.
We do not currently accept contributions for translated content, but we hope to in the future.
You can browse existing issues to find something that needs help!
You can use the GitHub user interface ✏️ for some small changes, like fixing a typo or updating a readme. You can also fork the repo and then clone it locally, to view changes and run your tests on your machine.
Here's some information that might be helpful while working on a Docs PR:
- Development - This short guide describes how to get this app running on your local machine.
- Content style guide for MicroStrategy Docs - This guide covers information about how we style our content and images. It also links to the resources we use for general style guidelines.
We (usually the docs team, but sometimes MicroStrategy product managers, engineers, or supportocats too!) review every single PR. The purpose of reviews is to create the best content we can for people who use MicroStrategy.
💛 Reviews are always respectful, acknowledging that everyone did the best possible job with the knowledge they had at the time.
💛 Reviews discuss content, not the person who created it.
💛 Reviews are constructive and start conversation around feedback.
You should always review your own PR first.
For content changes, make sure that you:
- Confirm the changes pass linter checks by running
yarn lint. - Make sure your content is rendered as expected by running
yarn start. - Review the content for technical accuracy.
- Confirm your changes follow the style guide.
You should always test your changes locally if the changes are more than just fixing some wording.
Start the site locally, by running yarn start in the root folder of the project. The site will be started locally with URL http://localhost:3000. Visit the site to make sure it is displayed well.
When you open a pull request, you must fill out the "Ready for review" template before we can review your PR. This template helps reviewers understand your changes and the purpose of your pull request.
We may ask for changes to be made before a PR can be merged, either using suggested changes or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.
As you update your PR and apply changes, mark each conversation as resolved.
This site can be developed on Windows, however a few potential gotchas need to be kept in mind:
- Regular Expressions: Windows uses
\r\nfor line endings, while Unix based systems use\n. Therefore when working on Regular Expressions, use\r?\ninstead of\nin order to support both environments. The Node.jsos.EOLproperty can be used to get an OS-specific end-of-line marker. - Paths: Windows systems use
\for the path separator, which would be returned bypath.joinand others. You could usepath.posix,path.posix.joinetc and the slash module, if you need forward slashes - like for constructing URLs - or ensure your code works with either. - Bash: Not every Windows developer has a terminal that fully supports Bash, so it's generally preferred to write scripts in JavaScript instead of Bash.