search

OAI / Outreach

5 stars 4 forks source link

Review event pages #48

Closed swaldron58 closed 4 months ago

swaldron58 commented 5 months ago

Please review the London, OZ and Paris event pages for accuracy and make suggestions for better content. https://www.openapis.org/events

SensibleWood commented 4 months ago

@dret @swaldron58 I have knocked up some fresh copy for the events, based on what was already there and from the apidays events pages: https://docs.google.com/document/d/1RukiCB1JbWKYKrqQzd3_yKS6OiytWtb_SC5tqF_Dmhw/edit?usp=sharing

Will provide access to both of you to review and move this ticket to "In Review" once completed

swaldron58 commented 4 months ago

Much improved but could you interject more about the OpenAPI relevance to the topics? Something like API description specifications provide an underlying commonality and predictability to defining and understanding API behaviors which allows automation which in turn fuels innovation. Or something to briefly explain why understanding what OpenAPI brings to the table is necessary to understand the future potential of APIs. We can't get to these lofty goals without underlying commonality and predictability.

dret commented 4 months ago

On 2024-06-24 23:33, Stu Waldron wrote:

Please review the London, OZ and Paris event pages for accuracy and make suggestions for better content. https://www.openapis.org/events https://www.openapis.org/events

great job in general, thanks a lot!

on https://www.openapis.org/events it seems like london has a nice chunk of text but the others have strange linebreaks and a lot of blank space. maybe there is some formatting in there that messes up the rendering?

dret commented 4 months ago

On 2024-06-26 22:59, Stu Waldron wrote:

Much improved but could you interject more about the OpenAPI relevance to the topics? Something like API description specifications provide an underlying commonality and predictability to defining and understanding API behaviors which allows automation which in turn fuels innovation. Or something to briefly explain why understanding what OpenAPI brings to the table is necessary to understand the future potential of APIs. We can't get to these lofty goals without underlying commonality and predictability.

Just to clarify: This was a question/request for @SensibleWood, right? Just checking...

SensibleWood commented 4 months ago

On 2024-06-26 22:59, Stu Waldron wrote: Much improved but could you interject more about the OpenAPI relevance to the topics? Something like API description specifications provide an underlying commonality and predictability to defining and understanding API behaviors which allows automation which in turn fuels innovation. Or something to briefly explain why understanding what OpenAPI brings to the table is necessary to understand the future potential of APIs. We can't get to these lofty goals without underlying commonality and predictability. Just to clarify: This was a question/request for @SensibleWood, right? Just checking...

Yes I think so @dret I'll sort it out

SensibleWood commented 4 months ago

Much improved but could you interject more about the OpenAPI relevance to the topics? Something like API description specifications provide an underlying commonality and predictability to defining and understanding API behaviors which allows automation which in turn fuels innovation. Or something to briefly explain why understanding what OpenAPI brings to the table is necessary to understand the future potential of APIs. We can't get to these lofty goals without underlying commonality and predictability.

@dret @swaldron58 I've added more funk and hyperbole as suggested and completed copy for all events. Please review again. Suggestions welcome but I think we are pretty much there in terms of setting the right tone