Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add ecosystem page #344

Merged
merged 4 commits into from Jan 3, 2024
Merged

Add ecosystem page #344

merged 4 commits into from Jan 3, 2024

Conversation

oraNod
Copy link
Contributor

@oraNod oraNod commented Dec 13, 2023

This PR adds an ecosystem page that migrates content from https://docs.ansible.com/ecosystem.html

@oraNod oraNod marked this pull request as draft December 13, 2023 18:05
samccann
samccann previously approved these changes Dec 13, 2023
Copy link
Contributor

@samccann samccann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LTGM Thanks!

@oraNod
Copy link
Contributor Author

oraNod commented Dec 14, 2023

Thanks for the review @samccann I've since updated this PR to add the documentation projects to the ecosystem. Could you please take a look at that? Is it too much?

samccann
samccann previously approved these changes Dec 14, 2023
Copy link
Contributor

@samccann samccann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@oraNod
Copy link
Contributor Author

oraNod commented Dec 14, 2023

Thanks again for the review @samccann I've rebased to remove the addition of the documentation projects. It would be better to create a separate PR for that as a follow up.

Copy link
Contributor

@samccann samccann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. One (ignorable nit) and one goober question just for my own edification.

text: Find out how to use collections
contributor_guide:
link: "https://docs.ansible.com/ansible/devel/community/contributions_collections.html#collections-contributions"
text: Learn how to contribute to collections
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a total nit, but this one and the one above (the text) - are anomalies on this page. Everything else is 'Foo documentation' etc, but these two are more action-oriented.

What about 'Collection user guide' and 'Collection contributor guide'?

I don't feel strongly about this so just tossing the idea out there and will marke the PR as approved.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see what you mean but this is a faithful reproduction of the current ecosystem page on the docsite. If we want to change that, I'd suggest a follow up PR.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok cool. I can do a followon pr once this merges.

@@ -20,6 +20,7 @@
@import "homepage-bullhorn-band";
@import "homepage-events-band";
@import "homepage-platform-band";
@import "ecosystem";
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I want to get a bit more knowledgeable about the website so taking a moment to ask the goober question here - why have a separate style sheet just for the ecosystem page? Wouldn't it help to set the same style for anything that uses buttons like this for example so we know they all stay the same on sub pages like this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Separate style sheets give more granular control so you don't make a change on one page that inadvertently changes styling on another page. It is good to try and have central, reusable components and we do that for buttons on the homepage here: https://github.com/ansible-community/community-website/blob/main/themes/ansible-community/sass/_homepage-clickable.scss

In the case of the ecosystem page the buttons are different to the homepage. Notice that they are "inline-block" instead of "flex" (which is inherited on the homepage).

I guess there are some properties that we can inherit from the homepage buttons but that can get tricky really fast. So I thought it would just be more straightforward to leave the ecosystem page as a unique thing in case someone else down the line needs to make a change. There's not as much complexity and you need to focus on one page instead of multiple pages, even though it does result in more properties.

Should we need to create another secondary page with buttons, it's entirely feasible to break the button styling out into a shared scss definition. To my knowledge there are no plans for that so I didn't bother to keep things self-contained and straightforward.

@oraNod oraNod merged commit 1b9f65e into ansible-community:main Jan 3, 2024
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants