From 1959858bf2d086d601d8c7d773529656a165d3c2 Mon Sep 17 00:00:00 2001 From: Benjamin Smith Date: Thu, 2 May 2024 10:26:32 -0700 Subject: [PATCH 1/4] update component renderer --- scripts/docs-collator/ComponentRenderer.py | 1 + 1 file changed, 1 insertion(+) diff --git a/scripts/docs-collator/ComponentRenderer.py b/scripts/docs-collator/ComponentRenderer.py index 7c0e59599..3865954ae 100644 --- a/scripts/docs-collator/ComponentRenderer.py +++ b/scripts/docs-collator/ComponentRenderer.py @@ -24,6 +24,7 @@ def render(self, component): module_download_dir = os.path.join(self.download_dir, 'modules', component) files = io.get_filenames_in_dir(module_download_dir, README_MD, True) + files += io.get_filenames_in_dir(module_download_dir, '*.md', True) for file in files: self.__render_doc(component, file) From d210b06f869d9cc43a0053b87ef1b68e6946a8ca Mon Sep 17 00:00:00 2001 From: Benjamin Smith Date: Thu, 2 May 2024 11:06:44 -0700 Subject: [PATCH 2/4] update component renderer --- scripts/docs-collator/ComponentRenderer.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/scripts/docs-collator/ComponentRenderer.py b/scripts/docs-collator/ComponentRenderer.py index 3865954ae..d7f159c6b 100644 --- a/scripts/docs-collator/ComponentRenderer.py +++ b/scripts/docs-collator/ComponentRenderer.py @@ -25,10 +25,14 @@ def render(self, component): files = io.get_filenames_in_dir(module_download_dir, README_MD, True) files += io.get_filenames_in_dir(module_download_dir, '*.md', True) + images = io.get_filenames_in_dir(module_download_dir, '*.png', True) for file in files: self.__render_doc(component, file) + for image in images: + io.copy_file(image, os.path.join(self.docs_dir, component, os.path.relpath(image, module_download_dir))) + def __render_doc(self, component, file): module_download_dir = os.path.join(self.download_dir, 'modules') @@ -48,7 +52,7 @@ def __render_doc(self, component, file): title = component github_edit_url = f"https://github.com/{GITHUB_REPO}/blob/master/modules/{relative_path}" - if len(relative_path.split('/')) > 2: # this is submodule + if len(relative_path.split('/')) > 2 and relative_path.split('/')[1] != 'docs' : # this is submodule submodule_name = os.path.basename(os.path.dirname(result_file)) label = submodule_name From c3583049ee6220da53439e7d1c347f770386af6b Mon Sep 17 00:00:00 2001 From: Benjamin Smith Date: Thu, 2 May 2024 12:09:11 -0700 Subject: [PATCH 3/4] fix: names of child docs --- scripts/docs-collator/ComponentRenderer.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/scripts/docs-collator/ComponentRenderer.py b/scripts/docs-collator/ComponentRenderer.py index d7f159c6b..912442d17 100644 --- a/scripts/docs-collator/ComponentRenderer.py +++ b/scripts/docs-collator/ComponentRenderer.py @@ -25,9 +25,12 @@ def render(self, component): files = io.get_filenames_in_dir(module_download_dir, README_MD, True) files += io.get_filenames_in_dir(module_download_dir, '*.md', True) + images = io.get_filenames_in_dir(module_download_dir, '*.png', True) for file in files: + if file.endswith(CHANGELOG_MD): + continue self.__render_doc(component, file) for image in images: @@ -48,8 +51,9 @@ def __render_doc(self, component, file): relative_path = os.path.relpath(file, module_download_dir) result_file = os.path.join(self.docs_dir, os.path.relpath(file, module_download_dir)) # /README.md - label = component - title = component + name = component if os.path.basename(file) == "README.md" else os.path.basename(file).replace(".md", "") + label = name + title = name github_edit_url = f"https://github.com/{GITHUB_REPO}/blob/master/modules/{relative_path}" if len(relative_path.split('/')) > 2 and relative_path.split('/')[1] != 'docs' : # this is submodule From 388bae11441b2cef42d1d30f31be560e16932752 Mon Sep 17 00:00:00 2001 From: Benjamin Smith Date: Thu, 2 May 2024 12:22:32 -0700 Subject: [PATCH 4/4] trigger build --- README.md | 156 +++++++++++++++------------------------------------- README.yaml | 2 + 2 files changed, 46 insertions(+), 112 deletions(-) diff --git a/README.md b/README.md index 4701db412..b46b4f2be 100644 --- a/README.md +++ b/README.md @@ -37,14 +37,6 @@ Let's jump right in! Here's how to get started with our documentation. --- This project is part of our comprehensive ["SweetOps"](https://cpco.io/sweetops) approach towards DevOps. -[][share_email] -[][share_googleplus] -[][share_facebook] -[][share_reddit] -[][share_linkedin] -[][share_twitter] - - @@ -64,8 +56,6 @@ It's 100% Open Source and licensed under the [Creative Commons Attribution-NonCo - - ## Usage @@ -93,36 +83,66 @@ Available targets: help Help screen help/all Display help for all targets help/short This help short screen + deps Install node modules + deps-production Install production only node modules + build Generate all static content (outputs to build/) using docker environment + start Start web server locally + real-clean Clean all dependencies and generated html files + all Run `clean`, `deps` and `build steps ``` +## Related Projects -## Share the Love +Check out these related projects. -Like this project? Please give it a ★ on [our GitHub](https://github.com/cloudposse/docs)! (it helps us **a lot**) +- [Geodesic](https://github.com/cloudposse/geodesic) - Geodesic is the fastest way to get up and running with a rock solid, production grade cloud platform -Are you using this project or any of our other projects? Consider [leaving a testimonial][testimonial]. =) +## ✨ Contributing +This project is under active development, and we encourage contributions from our community. +Many thanks to our outstanding contributors: + + + -## Related Projects +### 🐛 Bug Reports & Feature Requests -Check out these related projects. +Please use the [issue tracker](https://github.com/cloudposse/docs/issues) to report any bugs or file feature requests. -- [Geodesic](https://github.com/cloudposse/geodesic) - Geodesic is the fastest way to get up and running with a rock solid, production grade cloud platform +### 💻 Developing -## Help +If you are interested in being a contributor and want to get involved in developing this project or [help out](https://cpco.io/help-out) with our other projects, we would love to hear from you! Shoot us an [email][email]. -**Got a question?** We got answers. +In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow. -File a GitHub [issue](https://github.com/cloudposse/docs/issues), send us an [email][email] or join our [Slack Community][slack]. + 1. **Fork** the repo on GitHub + 2. **Clone** the project to your own machine + 3. **Commit** changes to your own branch + 4. **Push** your work back up to your fork + 5. Submit a **Pull Request** so that we can review your changes -[![README Commercial Support][readme_commercial_support_img]][readme_commercial_support_link] +**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request! + +### 🌎 Slack Community + +Join our [Open Source Community][slack] on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure. + +### 📰 Newsletter + +Sign up for [our newsletter][newsletter] that covers everything on our technology radar. Receive updates on what we're up to on GitHub as well as awesome new projects we discover. + +### 📆 Office Hours -## DevOps Accelerator for Startups +[Join us every Wednesday via Zoom][office_hours] for our weekly "Lunch & Learn" sessions. It's **FREE** for everyone! +## About + +This project is maintained and funded by [Cloud Posse, LLC][website]. + We are a [**DevOps Accelerator**][commercial_support]. We'll help you build your cloud infrastructure from the ground up so you can own it. Then we'll show you how to operate it and stick around for as long as you need us. @@ -143,52 +163,7 @@ We deliver 10x the value for a fraction of the cost of a full-time engineer. Our - **Code Reviews.** You'll receive constructive feedback on Pull Requests. - **Bug Fixes.** We'll rapidly work with you to fix any bugs in our projects. -## Slack Community - -Join our [Open Source Community][slack] on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure. - -## Discourse Forums - -Participate in our [Discourse Forums][discourse]. Here you'll find answers to commonly asked questions. Most questions will be related to the enormous number of projects we support on our GitHub. Come here to collaborate on answers, find solutions, and get ideas about the products and services we value. It only takes a minute to get started! Just sign in with SSO using your GitHub account. - -## Newsletter - -Sign up for [our newsletter][newsletter] that covers everything on our technology radar. Receive updates on what we're up to on GitHub as well as awesome new projects we discover. - -## Office Hours - -[Join us every Wednesday via Zoom][office_hours] for our weekly "Lunch & Learn" sessions. It's **FREE** for everyone! - -[![zoom](https://img.cloudposse.com/fit-in/200x200/https://cloudposse.com/wp-content/uploads/2019/08/Powered-by-Zoom.png")][office_hours] - -## Contributing - -### Bug Reports & Feature Requests - -Please use the [issue tracker](https://github.com/cloudposse/docs/issues) to report any bugs or file feature requests. - -### Developing - -If you are interested in being a contributor and want to get involved in developing this project or [help out](https://cpco.io/help-out) with our other projects, we would love to hear from you! Shoot us an [email][email]. - -In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow. - - 1. **Fork** the repo on GitHub - 2. **Clone** the project to your own machine - 3. **Commit** changes to your own branch - 4. **Push** your work back up to your fork - 5. Submit a **Pull Request** so that we can review your changes - -**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request! - - -## Copyright - -Copyright © 2017-2023 [Cloud Posse, LLC](https://cpco.io/copyright) - - - - +[![README Commercial Support][readme_commercial_support_img]][readme_commercial_support_link] ## License [![License](https://img.shields.io/badge/License-CC%20BY%20NC%20SA%204.0-blue.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/) @@ -209,45 +184,11 @@ Distribution of substantively modified versions of this document is prohibited w Distribution of the work or derivative of the work in any standard (paper) book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder. - - - - - - - ## Trademarks All other trademarks referenced herein are the property of their respective owners. - -## About - -This project is maintained and funded by [Cloud Posse, LLC][website]. Like it? Please let us know by [leaving a testimonial][testimonial]! - -[![Cloud Posse][logo]][website] - -We're a [DevOps Professional Services][hire] company based in Los Angeles, CA. We ❤️ [Open Source Software][we_love_open_source]. - -We offer [paid support][commercial_support] on all of our projects. - -Check out [our other projects][github], [follow us on twitter][twitter], [apply for a job][jobs], or [hire us][hire] to help with your cloud strategy and implementation. - - - -### Contributors - - -| [![Erik Osterman][osterman_avatar]][osterman_homepage]
[Erik Osterman][osterman_homepage] | [![Igor Rodionov][goruha_avatar]][goruha_homepage]
[Igor Rodionov][goruha_homepage] | [![Andriy Knysh][aknysh_avatar]][aknysh_homepage]
[Andriy Knysh][aknysh_homepage] | -|---|---|---| - - - [osterman_homepage]: https://github.com/osterman - [osterman_avatar]: https://img.cloudposse.com/150x150/https://github.com/osterman.png - [goruha_homepage]: https://github.com/goruha - [goruha_avatar]: https://img.cloudposse.com/150x150/https://github.com/goruha.png - [aknysh_homepage]: https://github.com/aknysh - [aknysh_avatar]: https://img.cloudposse.com/150x150/https://github.com/aknysh.png - +--- +Copyright © 2017-2024 [Cloud Posse, LLC](https://cpco.io/copyright) [![README Footer][readme_footer_img]][readme_footer_link] [![Beacon][beacon]][website] @@ -258,12 +199,9 @@ Check out [our other projects][github], [follow us on twitter][twitter], [apply [jobs]: https://cpco.io/jobs?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=jobs [hire]: https://cpco.io/hire?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=hire [slack]: https://cpco.io/slack?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=slack - [linkedin]: https://cpco.io/linkedin?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=linkedin [twitter]: https://cpco.io/twitter?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=twitter - [testimonial]: https://cpco.io/leave-testimonial?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=testimonial [office_hours]: https://cloudposse.com/office-hours?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=office_hours [newsletter]: https://cpco.io/newsletter?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=newsletter - [discourse]: https://ask.sweetops.com/?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=discourse [email]: https://cpco.io/email?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=email [commercial_support]: https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=commercial_support [we_love_open_source]: https://cpco.io/we-love-open-source?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=we_love_open_source @@ -274,11 +212,5 @@ Check out [our other projects][github], [follow us on twitter][twitter], [apply [readme_footer_link]: https://cloudposse.com/readme/footer/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=readme_footer_link [readme_commercial_support_img]: https://cloudposse.com/readme/commercial-support/img [readme_commercial_support_link]: https://cloudposse.com/readme/commercial-support/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/docs&utm_content=readme_commercial_support_link - [share_twitter]: https://twitter.com/intent/tweet/?text=Developer+Documentation&url=https://github.com/cloudposse/docs - [share_linkedin]: https://www.linkedin.com/shareArticle?mini=true&title=Developer+Documentation&url=https://github.com/cloudposse/docs - [share_reddit]: https://reddit.com/submit/?url=https://github.com/cloudposse/docs - [share_facebook]: https://facebook.com/sharer/sharer.php?u=https://github.com/cloudposse/docs - [share_googleplus]: https://plus.google.com/share?url=https://github.com/cloudposse/docs - [share_email]: mailto:?subject=Developer+Documentation&body=https://github.com/cloudposse/docs [beacon]: https://ga-beacon.cloudposse.com/UA-76589703-4/cloudposse/docs?pixel&cs=github&cm=readme&an=docs diff --git a/README.yaml b/README.yaml index 4ebb27c7d..b44b6dd47 100644 --- a/README.yaml +++ b/README.yaml @@ -43,3 +43,5 @@ contributors: github: "goruha" - name: "Andriy Knysh" github: "aknysh" + - name: "Benjamin Smith" + github: "Benbentwo"