On Sun, Feb 14, 2021 at 10:51 PM Sijie Guo <guosi...@gmail.com> wrote:
> Not sure about renaming the blog to announcements. Let's first leave the > blog part unchanged and focus on the documentation site enhancement. > This isn't a big deal, but I don't see the downside to renaming it to something that better reflects its stated purpose. > - REST APIs and Admin CLI have sub-dropdowns in the current site. We can > > either move these into a simple list in a new page, or we can just move > the > > sub-dropdowns into the menu (“Admin REST API, Functions REST API, Sources > > REST API,” etc) > > > > All REST API and Admin CLI are versioned. I am not sure what are the > benefits we get from here. > > Also even we can move them to a simple list, it is unclear how we are going > to maintain that moving forward. So a PR to demonstrate or a detailed write > up would help here. > > What is the main purpose of removing the "clients" menu? > The motivation behind both of these is twofold. First, streamlining the header helps direct new users towards the most important places for them to get started. Second, it's just a suboptimal user experience to have docs spread across three parts of the header. > >
