asyncapi / website

AsyncAPI specification website
https://www.asyncapi.com
Apache License 2.0
506 stars 648 forks source link

Press tab #195

Closed Barbanio closed 2 years ago

Barbanio commented 3 years ago

Hello, @alejandrolmiguel and I thought it would be a good idea to have a press tab on the website to facilitate contact with the press. The information we would like to have in the press tab would be:

What do you think? Thanks in advance :)

github-actions[bot] commented 3 years ago

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.

Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

derberg commented 3 years ago

@Barbanio makes sense! just do not know what you mean by Access to the blog

Barbanio commented 3 years ago

Sorry, I mean that you can access directly from that tab to the blog, with a link or section that takes you to the blog when you click on it. Do you understand me now?

derberg commented 3 years ago

so blog in the top navigation is not enough you mean?

Barbanio commented 3 years ago

Yes, this would simply be a button that takes journalists directly to the blog. The idea is to make it easier to access the information most relevant to them in one tab.

derberg commented 3 years ago

Makes sense πŸ‘πŸΌ

derberg commented 3 years ago

@Barbanio what is press kit?

I saw that on few press pages people put project icons so they are easier to access, like all bringing related

Barbanio commented 3 years ago

@derberg Yes, it's very common for any company, enterprise, or project to have a press kit, it is very important in terms of public relations and communication. It's a document that gathers all the relevant information of the project (mission, objectives, values, etc.), it could be said that it is the letter of introduction.

Álex and I worked on this: https://docs.google.com/document/d/1U3k_YnMIdJUaTmw16X6CZR5KPMgl0_Ml/edit#heading=h.9k4byahtrni1

derberg commented 3 years ago

@Barbanio you do not have to convince me, I like the idea. I just asked about The press kit that you have on the list, what exactly is it? the document you linked or? Sorry for not expressing myself clearly in initial comment

Barbanio commented 3 years ago

@derberg Yes, it's that document.

hkaur008 commented 3 years ago

Hey , Can i still take up this issue ? If yes then let me know the task and task files .

derberg commented 3 years ago

@Barbanio hey, @hkaur008 wants to help out creating the press tab. Can you provide her with all the data and files needed for it? I mean what exactly needs to be provided on the website? Without this it will be hard to even provide a mockup

Aside from the list of the things provided in the issue description, I think we should also expose on the press table the brand files, logos I mean, the ones that we have here https://drive.google.com/drive/u/1/folders/17XAR-6D8Le7iQT3Y6laKNBsaGj_8DStF ?

Also, the issue is called press tab but it also might be just a press drop down in navigation with just a bunch of links maybe, to all these different resources, or dedicated views. Just a hint to explore different options, and review how others do it

Barbanio commented 3 years ago

Hi! sure, @hkaur008 your willingness is great!

I think the most important are the newsgathering points, press releases, and the press kit because the rest would be links.

@derberg I think it is a very good idea to put the brand files as well.

We can see how this information is presented in other projects.

hkaur008 commented 3 years ago

Sorry, I just had my last exam today! Okay, As far as I understand it would be just a section to give insights about many things Asyncapi is up to .

  1. So I have to build a section where we can display/render the latest news about AsyncAPI
  2. One press releases section to have the latest 2 or 3 press releases, Suggestion : we can link to the section having all press releases
  3. How you want to display presskit ? Currently its a doc file . A separate article kind of page or anything else ?

Please let me now where I have to code for same , any file reference or folder or frontend design which is needed to be built 😊

Barbanio commented 3 years ago

Hi, I hope your exams went well :) Yes, the initial idea is to put all the information inside a press section, something like Postman or Nordic APIs for example: https://www.postman.com/company/press-media/ https://nordicapis.com/about/press/ Press kit document I think we could put it in .pdf format, what do you think?

hkaur008 commented 3 years ago

https://www.postman.com/company/press-media/ they are having a different section for press media . I was unable to find link to press media on their site , was that in footer ? i will work accordingly

Barbanio commented 3 years ago

Yes, it's in the footer, in "company", the last column on the right 😊

hkaur008 commented 3 years ago

So , what exactly i have to do ? Can you please list works and where I have to code . 😊

derberg commented 3 years ago

That would be it from me. This would be the first part, a footer with links to external resources.

Now the second part is the list of articles about AsyncAPI in media. @Barbanio I guess you are referring to articles from InfoQ, Linux Foundation. Please first suggest a list of articles and what would be the URL pointing to the view with list, asyncapi.com/? asyncapi.com/mentions?

@hkaur008 I guess you are partially unblocked now?

Barbanio commented 3 years ago

Yes, I'm referring to those types of articles. These are the most relevant ones I have found, I'm sure I'm forgetting some of them. The same news is covered by different media and different news is covered by the same media like Info Q. In principle, I think we can put them all acquiring the added value of those media that talk about AsyncAPI. What do you think? On the other hand, I think they would fit better in asyncapi.com/mentions.

Articles:

derberg commented 3 years ago

I think we should put emphasis on news diversity and avoid duplication. In other words, media news about "AsyncAPI joining Linux Foundation" should show up just once and from different source than InfoQ cause we have other articles from them.

Does it make sense?

I see you have one article in German, so we definitely need to clearly separate in the UI, news in English from news in different lanugages.

Barbanio commented 3 years ago

Yes, it makes sense, the same goes for the Postman and AsyncAPI news. I have selected the media by the quality of the news and by the number of visits per month and the list would look like this:

Do you think it is relevant that the German media appears in this case, or that in the future other media that do not work in English will appear?

derberg commented 3 years ago

I think it is fine to list mentions in other languages, why not, just pick some written in Spanish, at least one.

I imagine the list of articles shows up like this but of course, instead of people image, there would be an article cover photo. Such a grid view could be separated by some label, English-written articles at the top, and then below other languages

hkaur008 commented 3 years ago

current footer on site: image what else links i need to add ? Got code for new footer Option 1 image Similar to current in theming Option 2 image darker Better one acc to ur suggestions ?

magicmatatjahu commented 3 years ago

@hkaur008 Hi! We should choose the first option (white), similar to current design :)

what else links i need to add ?

As @derberg wrote, you should add links from this https://github.com/asyncapi/website/issues/195#issuecomment-847689807 comment

I only don't know which links and in which way we should show them, I mean to which groups we should split the links. In the future we should have groups: Tooling, Support, Company and there I have a problem for Press link/group, because usually Press is an another link in the Company group but Łukasz wants in the https://github.com/asyncapi/website/issues/195#issuecomment-847689807 comment that Press should be as a separate group, next to the Company. For me we can go with it, but let's see what other people think, @fmvilas @jonaslagoni @smoya @Barbanio

Related to articles: I think that we should have an 4th link named Articles with link asyncapi.com/press-and-media and this page should be similar to our /blog page, however, we should create this as the next PR, because there will be a lot to do.

I also add link to original design of footer, for other people from community https://tailwindui.com/components/marketing/sections/footers

AlejandrolMiguel commented 3 years ago

Hi guys! I hope everything is going well. I know that you miss me (im adorable) , but please let me out of this e-mails. Thanks! Alejandro

derberg commented 3 years ago

I think it is ok if we go as simple as possible here, so just have two sections in white footer,

in follow up PRs we can extend Others into separate sections, in a separate discussion about it.

Barbanio commented 3 years ago

HI! I don't know if this is the ideal place to leave this information... I have created a repository with the press kit in markdown in case one day it is uploaded to the web or someone needs it in .md

I edit the link to the PR: https://github.com/Barbanio/Press-Kit/pull/1

fmvilas commented 3 years ago

@Barbanio I see there are style issues with the headings on the press kit. For instance here but it's repeating the same thing in every heading. I think we should not be copying the styles from the original document and instead put the headings in a single line. Does it make sense?

Barbanio commented 3 years ago

@fmvilas Sure, it makes sense, it looks better now.

fmvilas commented 3 years ago

I have a few more comments to make. Would you mind creating a PR? It's hard to give feedback this way πŸ˜…

Barbanio commented 3 years ago

Sorry, I think it's better now. https://github.com/Barbanio/Press-Kit/pull/1

fmvilas commented 3 years ago

No need to apologize 😊 Thanks for taking the time!

github-actions[bot] commented 2 years ago

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

Barbanio commented 2 years ago

@all-contributors please add @Barbanio for idea

allcontributors[bot] commented 2 years ago

@Barbanio

I've updated the pull request to add @Barbanio! :tada:

allcontributors[bot] commented 2 years ago

@hkaur008

I could not determine your intention.

Basic usage: @all-contributors please add @someone for code, doc and infra

For other usages see the documentation

hkaur008 commented 2 years ago

@all-contributors please add @hkaur008 for code

allcontributors[bot] commented 2 years ago

@hkaur008

I've put up a pull request to add @hkaur008! :tada:

github-actions[bot] commented 2 years ago

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

Harish-b-03 commented 2 years ago

Hello Everyone 😁. Heyyy @derberg, as discussed in Slack, I would like to work on this issue and really excited. So to start with that, as referred earlier can we have postman website design or can we make any changes image Like this, Can we go with just two groups:- one for press and articles, another for other links, As you mentioned @derberg in https://github.com/asyncapi/website/issues/195#issuecomment-861464556. Just to get my understanding better, I will do some rough work with draft layout and let u all know by tomorrow evening . It would be really helpful if I get all your inputs and references πŸ˜ƒ

derberg commented 2 years ago

@Harish-b-13 thanks!

can we have postman website design

we definitely cannot follow Postman 1:1 as we should follow https://github.com/asyncapi/brand/blob/master/brand-guidelines/README.md that @mcturco published just yesterday. But yeah, the idea is pretty common everywhere, so columns with links. What I like in the Postman footer is the Social section. We should definitely get it too, instead of the current list of icons only

Can we go with just two groups:- one for press and articles, another for other links

I'm not sure how to name group that will have Press and Brand links πŸ€”

But yeah, basically new footer overrides πŸ‘‡πŸΌ

Screenshot 2022-05-19 at 10 01 07

I wonder what others think

Harish-b-03 commented 2 years ago

Heyy EveryoneπŸ˜ƒ. So to get an idea, made some changes in the footer and played with it

image

I would like to get everyone's suggestions, ideas and improvements required.

Explanation:

And @derberg can I start to work on the new page to render the press release documents and articles that @Barbanio mentioned or what is your plan to implement this? πŸ˜„ πŸ˜„.

I would like to appreciate @mcturco for the work πŸ˜„. @mcturco, I want to bring one issue to your concern that in the logos directory, the primary logos of AsyncAPI PNG format has two variants right... so there the light version was named as dark and the other way for the dark version. Kindly please have a look at it.

@derberg I would like to get your suggestions, ideas and improvements that are required.

Thank you😊

mcturco commented 2 years ago

Hey @Harish-b-13! Thank you so much for putting this together. I am loving the layout that you proposed! I just have a few UI suggestions. Here is a quick mock-up that I put together to help visualize what I am proposing we change:

Screen Shot 2022-05-20 at 1 24 06 PM (Open in Figma)

I am still pretty confused about the Press links that we need to have in the footer, forgive me if I missed it earlier in this issue but I know the current Press link is just a mailto: link, which I don't think the link text communicates that properly. I think we still need to have a further discussion on how we are going to organize these links, but just wanted to propose my UI idea.

I would like to appreciate @mcturco for the work πŸ˜„. @mcturco, I want to bring one issue to your concern that in the logos directory, the primary logos of AsyncAPI PNG format has two variants right... so there the light version was named as dark and the other way for the dark version. Kindly please have a look at it.

Thank you for pointing that out! πŸ™ I must have confused myself thinking that the light one would be for dark mode and vice versa. Great catch! Going to submit an issue in brand to resolve that πŸ‘

Harish-b-03 commented 2 years ago

Heyy @mcturco. Thank you for suggestions.

I changed the column named Company to The Initiative

That's a very good change, I didnt think of this and lets see what others are thinking. Curiously waiting for @derberg 's input 😁

All the other changes you made, are valid one and I will change according to this. Lets wait for @derberg. And once again Thank you very much for your time and valuable suggestionπŸ˜ƒ.

derberg commented 2 years ago

this looks amazing, thanks @Harish-b-13 for coming up with proposal so fast and @mcturco for great mockups right away ❀️

my only point is that yes, we should have Slack link in Social, and we should also put Twitch there -> https://www.twitch.tv/asyncapi

Harish-b-03 commented 2 years ago

Hello Everyone πŸ˜ƒ. Soo, I have made all the changes.

image

Now, I need your help @derberg , I dont know which link, I have to use for Slack in Social. It would be helpful if u provide me the link that should be included. And is there any changes that I have to make in this layout.

And @derberg can I start to work on the new page to render the press release documents and articles that Barbanio mentioned or what is your plan to implement this? πŸ˜„ πŸ˜„

Eagerly waiting for your inputs @derberg and @mcturco .

Thank you

magicmatatjahu commented 2 years ago

@Harish-b-13 Hi! I don't know what @derberg wants to do with press page, but it would be best if you opened a PR with a new footer and we would do a review :)

derberg commented 2 years ago

for slack please use -> https://asyncapi.com/slack-invite

for press, yes, we need new simple page with content mentioned by @Barbanio as simple as https://www.asyncapi.com/about

Harish-b-03 commented 2 years ago

Helloo @magicmatatjahu πŸ˜ƒ. Thank you very much for your response. Please give me some time to create the page to display the contents. For sure, will submit a PR by tomorrow.πŸ˜„

Heyy @derberg πŸ˜ƒ. Thank you very much. Will complete the work by tomorrow and will submit a PR.πŸ˜„

Thank you😊