From fd1600da3645f922deb73842f6beb648723e66d2 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 10:03:25 -0400 Subject: [PATCH 1/9] Add .gitignore --- .gitignore | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..79eb21e --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +# Ignore editor and OS-specific files +.DS_Store +Thumbs.db +.idea/ +.vscode/ +*.swp +*.swo +*.bak +*.tmp +~$* \ No newline at end of file From a2d39447b39bd3a6561bb07a63c1946eb15eb897 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 10:06:43 -0400 Subject: [PATCH 2/9] docs: add gh profile README.md --- profile/README.md | 48 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 profile/README.md diff --git a/profile/README.md b/profile/README.md new file mode 100644 index 0000000..d3e8a3c --- /dev/null +++ b/profile/README.md @@ -0,0 +1,48 @@ +## Itential +Innovation is unlocked when we **Collaborate, Contribute, and Create** together. Here you can find open-source tools, ready to use community assets, _battle-tested_ collections used to deploy validated Itential architectures, and more. + +

+Blog  +LinkedIn  +Twitter/X  +YouTube +

+ +--- + +## 🛠️ Open Source Ecosystem +Explore our growing collection of open-source tools and integrations: + +| Repository | Description | +|------------|-------------| +| **[itential-mcp](https://github.com/itential/itential-mcp)** | MCP Server for Itential Platform integration | +| **[ipsdk](https://github.com/itential/ipsdk)** | Itential Python SDK for platform automation | +| **[itential.deployer](https://github.com/itential/itential.deployer)** | Ansible collection for deploying validated architectures | +| **[itential.iag5](https://github.com/itential/itential.iag5)** | Ansible collection for Itential Gateway v5 | +| **[iap-helm](https://github.com/itential/iap-helm)** | Kubernetes Helm charts for Itential Automation Platform | +| **[iag5-helm](https://github.com/itential/iag5-helm)** | Kubernetes Helm charts for Itential Gateway v5 | +| **[assets](https://github.com/itential/assets)** | Ready to import Community Assets | + +--- + +## 🤝 Contributing +We welcome contributions from the community! Each repository contains specific contribution guidelines and code of conduct. Please review the individual repository documentation before submitting pull requests. + +For general inquiries about contributing to Itential open-source projects, contact us at [opensource@itential.com](mailto:opensource@itential.com). + +--- + +## 📄 License +Our open-source projects are licensed under various licenses including Apache-2.0 and GPL-3.0. Please refer to individual repository LICENSE files for specific terms. + +--- + +
+ +**Unify your tools, teams, and environments with a platform built to streamline network and infrastructure operations at scale.** + +*Itential Platform | Accelerate. Standardize. Scale.* + +[Blog](https://itential.com/blog) • [Learn More](https://itential.com) • [Careers](https://itential.com/careers) + +
From 739f5cd3d4b733fe3abe14b92ca94870b676b130 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:01:23 -0400 Subject: [PATCH 3/9] docs: add CONTRIBUTING.md --- CONTRIBUTING.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..be60eb0 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,37 @@ +# Contributing +This repository contains the Itential organization profile displayed at https://github.com/itential. + +## Getting Started +We welcome contributions to improve our organization profile. This includes: +- Adding new repositories to the ecosystem table +- Updating repository descriptions +- Fixing typos or broken links +- Improving clarity and messaging + +## Workflow +This repository uses the **Fork and Pull** model: + +1. **Fork** this repository to your GitHub account +2. **Clone** your fork locally +3. **Create** a feature branch (`docs/update-description`) +4. **Make** your changes to `profile/README.md` +5. **Test** all links and preview changes +6. **Commit** using conventional commit format (see below) +7. **Push** to your fork +8. **Open** a Pull Request + +## Commit Format +Use conventional commits: +- `docs: add new repository to ecosystem table` +- `docs: update LinkedIn badge URL` +- `fix: correct broken link to blog` + +Format: `: ` (≤50 chars, imperative mood) + +## Review Process +- All PRs require link checking and markdown linting to pass +- Changes will be reviewed by maintainers +- Updates should maintain the existing format and structure + +## Questions? +Contact us at opensource@itential.com \ No newline at end of file From edc723fb7d6444afe4d6eda9efce31de73330381 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:02:16 -0400 Subject: [PATCH 4/9] Add link-checker on PR --- .github/workflows/link-checker.yml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 .github/workflows/link-checker.yml diff --git a/.github/workflows/link-checker.yml b/.github/workflows/link-checker.yml new file mode 100644 index 0000000..0558407 --- /dev/null +++ b/.github/workflows/link-checker.yml @@ -0,0 +1,21 @@ +name: Link Checker + +on: + pull_request: + paths: + - '**.md' + +jobs: + link-check: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Check links + uses: lycheeverse/lychee-action@v2 + with: + args: --verbose --no-progress '**/*.md' + fail: true + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} From 22f901e2593bfad4899840b35c6896891915454e Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:02:28 -0400 Subject: [PATCH 5/9] Add linting on PR --- .github/workflows/markdown-lint.yml | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 .github/workflows/markdown-lint.yml diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml new file mode 100644 index 0000000..cec5a12 --- /dev/null +++ b/.github/workflows/markdown-lint.yml @@ -0,0 +1,25 @@ +name: Markdown Lint + +on: + pull_request: + paths: + - '**.md' + +jobs: + markdown-lint: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Lint markdown files + uses: DavidAnson/markdownlint-cli2-action@v18 + with: + globs: '**/*.md' + config: | + { + "default": true, + "MD013": false, + "MD033": false, + "MD041": false + } \ No newline at end of file From 36a5697de746255a9e9b2e4f8dff2764ef26b90d Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:02:37 -0400 Subject: [PATCH 6/9] Add PR template --- .github/pull_request_template.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .github/pull_request_template.md diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..d414353 --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,14 @@ +## Description + + +## Checklist +- [ ] Links tested and verified +- [ ] Spelling and grammar checked +- [ ] Previewed changes locally +- [ ] Follows conventional commit format + +## Additional Context + + +--- +See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines. \ No newline at end of file From 4eadba4c73495905d19f069086a0995364564ec4 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:10:47 -0400 Subject: [PATCH 7/9] fix: pointer to .markdownlist.json --- .github/workflows/markdown-lint.yml | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml index cec5a12..0f5fa19 100644 --- a/.github/workflows/markdown-lint.yml +++ b/.github/workflows/markdown-lint.yml @@ -15,11 +15,4 @@ jobs: - name: Lint markdown files uses: DavidAnson/markdownlint-cli2-action@v18 with: - globs: '**/*.md' - config: | - { - "default": true, - "MD013": false, - "MD033": false, - "MD041": false - } \ No newline at end of file + globs: '**/*.md' \ No newline at end of file From b78e145a067761869909e5036976670f99ed7020 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:10:55 -0400 Subject: [PATCH 8/9] Add .markdownlist.json --- .markdownlint.json | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .markdownlint.json diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 0000000..1dd8622 --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,6 @@ +{ + "default": true, + "MD013": false, + "MD033": false, + "MD041": false +} From 64899ace98839112ba32af9620b48d0225dbceb3 Mon Sep 17 00:00:00 2001 From: wcollins Date: Tue, 28 Oct 2025 11:15:16 -0400 Subject: [PATCH 9/9] fix: indentation / spacing --- .github/pull_request_template.md | 5 ++++- CONTRIBUTING.md | 12 ++++++++++-- profile/README.md | 6 +++++- 3 files changed, 19 insertions(+), 4 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index d414353..073e50f 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,7 +1,9 @@ ## Description + ## Checklist + - [ ] Links tested and verified - [ ] Spelling and grammar checked - [ ] Previewed changes locally @@ -11,4 +13,5 @@ --- -See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines. \ No newline at end of file + +See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index be60eb0..db6c6ae 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,14 +1,18 @@ # Contributing -This repository contains the Itential organization profile displayed at https://github.com/itential. + +This repository contains the Itential organization profile displayed at . ## Getting Started + We welcome contributions to improve our organization profile. This includes: + - Adding new repositories to the ecosystem table - Updating repository descriptions - Fixing typos or broken links - Improving clarity and messaging ## Workflow + This repository uses the **Fork and Pull** model: 1. **Fork** this repository to your GitHub account @@ -21,7 +25,9 @@ This repository uses the **Fork and Pull** model: 8. **Open** a Pull Request ## Commit Format + Use conventional commits: + - `docs: add new repository to ecosystem table` - `docs: update LinkedIn badge URL` - `fix: correct broken link to blog` @@ -29,9 +35,11 @@ Use conventional commits: Format: `: ` (≤50 chars, imperative mood) ## Review Process + - All PRs require link checking and markdown linting to pass - Changes will be reviewed by maintainers - Updates should maintain the existing format and structure ## Questions? -Contact us at opensource@itential.com \ No newline at end of file + +Contact us at diff --git a/profile/README.md b/profile/README.md index d3e8a3c..8a9e80f 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,4 +1,5 @@ ## Itential + Innovation is unlocked when we **Collaborate, Contribute, and Create** together. Here you can find open-source tools, ready to use community assets, _battle-tested_ collections used to deploy validated Itential architectures, and more.

@@ -11,6 +12,7 @@ Innovation is unlocked when we **Collaborate, Contribute, and Create** together. --- ## 🛠️ Open Source Ecosystem + Explore our growing collection of open-source tools and integrations: | Repository | Description | @@ -26,6 +28,7 @@ Explore our growing collection of open-source tools and integrations: --- ## 🤝 Contributing + We welcome contributions from the community! Each repository contains specific contribution guidelines and code of conduct. Please review the individual repository documentation before submitting pull requests. For general inquiries about contributing to Itential open-source projects, contact us at [opensource@itential.com](mailto:opensource@itential.com). @@ -33,6 +36,7 @@ For general inquiries about contributing to Itential open-source projects, conta --- ## 📄 License + Our open-source projects are licensed under various licenses including Apache-2.0 and GPL-3.0. Please refer to individual repository LICENSE files for specific terms. --- @@ -41,7 +45,7 @@ Our open-source projects are licensed under various licenses including Apache-2. **Unify your tools, teams, and environments with a platform built to streamline network and infrastructure operations at scale.** -*Itential Platform | Accelerate. Standardize. Scale.* +_Itential Platform | Accelerate. Standardize. Scale._ [Blog](https://itential.com/blog) • [Learn More](https://itential.com) • [Careers](https://itential.com/careers)