Re: question about publishing to API portal

Jeff Brower


Ok understood, that makes sense. Redoc is good. Thanks.


We are hosting this for the community in our cloud as there was no
precedent to follow. We used the following open source

Easiest way is to express API in a popular format using protobuf and
generate swagger definitions. I can ask my engineer to help with launch
once the community approves the updated set.

As developer APIs shall consume Infra APIs so there might be a need to
build a validation cycle in community labs. We are still in process to
figure that out.

On Wed, May 20, 2020 at 6:21 PM Jeff Brower <@jbrower> wrote:


Ok got it. At some point in the future when there are APIs approved and
can be added, how is the page accessed / edited ? That's what I need to
know, so I can come up with publishing / editing method for API
subcommittee guys.


-Jeff as domain suggests is for final approved APIs by the

Working docs go under

On Wed, May 20, 2020 at 6:09 PM Jeff Brower <@jbrower>


I'm referring to:

How to edit that page ?


Hi Jeff,
+ adding theapi@... mail list to advise. may be the best
place to


On Wed, May 20, 2020 9:54 PM, Jeff Brower @jbrower

I'm helping with API architecture diagrams, maps, and other items that
we (API
subcommittee) want to add to the API portal (

What is your recommended method for publishing Powerpoint, MindMap,
doc types to the API portal URL ? I know HTML very well, so I have no

problem to export PowerPoint to HTML and then upload to a site and
with what's already there. But I'm worried to lead subcommittee guys

down a path where they need a lot of HTML knowledge and what they
becomes difficult to maintain.

Are you using a hosted method for the portal; i.e. something similar
SquareSpace, Wix, Wordpress, etc ? Is there an ftp backend where we

upload HTML pages ?

Thanks for any advice.


Brett PrestonThe Linux Foundation+1 (971) 303-9030
Google Talk:bpreston@...: bprestoncf

Join to automatically receive all group messages.