Welcome to the Arc Jumpstart documentation repository! This repository is your go-to resource for in-depth guides, best practices, and detailed documentation related to Azure Arc. Whether you're a beginner exploring the basics or an experienced user optimizing your deployment, you'll find valuable insights tailored to your needs. This repository complements our source code repository and acts has the documentation source repository which populates the Arc Jumpstart website.
Note: This repository doesn't contain the source code for the automation scripts and tools of the Arc Jumpstart. The source code for Arc Jumpstart can be found in another dedicated repository.
- Documents: Arc Jumpstart markdown files utilized in scenarios and solutions, offering comprehensive technical information.
- Visual Resources: Clear and concise screenshots providing visual context for easier comprehension of the documentation.
- Supportive Documents and Files: Additional resources used across the Arc Jumpstart website, aiding in various contexts and providing supplemental information.
This documentation repository is tailored for contributors and works in tandem with the our source code repository. While not mandatory, it's highly probable that contributors will need to clone both repositories to effectively contribute to Arc Jumpstart.
Before you start, we recommend familiarizing yourself with our comprehensive contribution guidelines. These guidelines outline the standards and practices we follow, ensuring consistency and quality across our documentation.
If you're unsure about your future contribution, don't hesitate to start a GitHub discussion. This is a great place to ask questions, share ideas, or get feedback on potential contributions. Our community is here to help and we welcome all levels of experience.
Happy contributing!
The Arc Jumpstart docs repository handles branching similarly to most code repositories. Two primary branches are maintained, each one attached to a specific website slot (prod/canary).
The following branches are currently maintained:
| Branch | Website | Description |
|---|---|---|
| main (primary) | https://arcjumpstart.com/ | Latest Arc Jumpstart release documentation. This is the latest documentation available in the deployed to the production slot. |
| canary (canary) | https://preview.arcjumpstart.com/ | Pre-release documentation. Doc updates should be merged to the canary branch for preview validation before merging to the main branch. |
To contribute, you'll likely need to clone both this repository and the source code repository. Use the following commands:
git clone https://github.com/Azure/arc_jumpstart_docs.git
git clone https://github.com/microsoft/azure_arc.gitAs we continuously improve and expand Arc Jumpstart, we recommend keeping your local clones of the repositories up-to-date. You can do this by pulling the latest changes from the main branch:
git pull origin mainYour input is highly valued! If you have suggestions, feedback, or valuable insights to share, feel free to open an issue. Your contributions help improve the documentation for the entire community.
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 Arc Jumpstart team the rights to use your contribution. For details, visit https://cla.opensource.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 (for example, status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using Microsoft's 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.
This repository uses vale.sh to help tech writers and contributors adhere to Microsoft's writing styling guidelines. Vale is a command-line tool that allows you to check your writing for grammar and spelling errors against a set of style rules.
For more information about Vale configuration, local usage and GitHub CI actions, check Wiki - Vale Integration.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines.
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.