Re: [Input Needed] Updating the documentation left navigation (was:Website Revamp update & navigation for documentation page)
I see. Yes, I meant that things like (or some level) do not appear in the right nav. I see, if content is the next round I will save more comments. I think that once we have a style, including what levels are shown where, then it will be time to fix content issues. Kenn On Mon, Dec 21, 2020 at 10:46 AM Griselda Cuevas wrote: > Are you referring to things missing in the left navigation or in the right > one? > > If things are missing on the left navigation, we will fix in this round, > if there are things missing in the right navigation we won't fix this time > around, the right navigation is automatically created from formatting in > the documentation, displaying headers/sub-headers, and we won't touch the > actual content this time around. > > On Mon, 21 Dec 2020 at 09:40, Kenneth Knowles wrote: > >> I like the change. The left nav is inconsistent about things being >> re-collapsed when we return to the page anyhow, and I never really >> understood what part of navigation belonged in which side. >> >> And it seems there are still more levels of subheaders than we can >> display. Is the plan to simply not have those in the nav? (this seems fine >> with me) >> >> Kenn >> >> On Mon, Dec 14, 2020 at 7:30 PM Griselda Cuevas wrote: >> >>> Hi dev@ community, >>> >>> >>> I wanted to fork this conversation to make it more visible. We'd like to >>> get your feedback on the proposed update for the documentation page in the >>> website. >>> >>> >>> The proposed change is that the left navigation (which is the website >>> main navigation) stays high level and only shows titles, leaving the >>> detailed hierarchy in the right navigation, which appears when you click on >>> a Documentation topic or when you land directly on it. >>> >>> >>> You can see a screenshot of the current and proposed designs in the wiki >>> repo with the other website designs [1]. The names of the files are: >>> current_DocsNav for the current design, and proposed_DocsNav for the >>> proposed design. >>> >>> >>> Please let us know your preference or suggestions through this week. >>> >>> >>> Gris >>> >>> >>> [1] >>> https://cwiki.apache.org/confluence/display/BEAM/Website+Redesign+Files >>> >>
Re: [Input Needed] Updating the documentation left navigation (was:Website Revamp update & navigation for documentation page)
Are you referring to things missing in the left navigation or in the right one? If things are missing on the left navigation, we will fix in this round, if there are things missing in the right navigation we won't fix this time around, the right navigation is automatically created from formatting in the documentation, displaying headers/sub-headers, and we won't touch the actual content this time around. On Mon, 21 Dec 2020 at 09:40, Kenneth Knowles wrote: > I like the change. The left nav is inconsistent about things being > re-collapsed when we return to the page anyhow, and I never really > understood what part of navigation belonged in which side. > > And it seems there are still more levels of subheaders than we can > display. Is the plan to simply not have those in the nav? (this seems fine > with me) > > Kenn > > On Mon, Dec 14, 2020 at 7:30 PM Griselda Cuevas wrote: > >> Hi dev@ community, >> >> >> I wanted to fork this conversation to make it more visible. We'd like to >> get your feedback on the proposed update for the documentation page in the >> website. >> >> >> The proposed change is that the left navigation (which is the website >> main navigation) stays high level and only shows titles, leaving the >> detailed hierarchy in the right navigation, which appears when you click on >> a Documentation topic or when you land directly on it. >> >> >> You can see a screenshot of the current and proposed designs in the wiki >> repo with the other website designs [1]. The names of the files are: >> current_DocsNav for the current design, and proposed_DocsNav for the >> proposed design. >> >> >> Please let us know your preference or suggestions through this week. >> >> >> Gris >> >> >> [1] >> https://cwiki.apache.org/confluence/display/BEAM/Website+Redesign+Files >> >
Re: [Input Needed] Updating the documentation left navigation (was:Website Revamp update & navigation for documentation page)
I like the change. The left nav is inconsistent about things being re-collapsed when we return to the page anyhow, and I never really understood what part of navigation belonged in which side. And it seems there are still more levels of subheaders than we can display. Is the plan to simply not have those in the nav? (this seems fine with me) Kenn On Mon, Dec 14, 2020 at 7:30 PM Griselda Cuevas wrote: > Hi dev@ community, > > > I wanted to fork this conversation to make it more visible. We'd like to > get your feedback on the proposed update for the documentation page in the > website. > > > The proposed change is that the left navigation (which is the website main > navigation) stays high level and only shows titles, leaving the detailed > hierarchy in the right navigation, which appears when you click on a > Documentation topic or when you land directly on it. > > > You can see a screenshot of the current and proposed designs in the wiki > repo with the other website designs [1]. The names of the files are: > current_DocsNav for the current design, and proposed_DocsNav for the > proposed design. > > > Please let us know your preference or suggestions through this week. > > > Gris > > > [1] > https://cwiki.apache.org/confluence/display/BEAM/Website+Redesign+Files >
[Input Needed] Updating the documentation left navigation (was:Website Revamp update & navigation for documentation page)
Hi dev@ community, I wanted to fork this conversation to make it more visible. We'd like to get your feedback on the proposed update for the documentation page in the website. The proposed change is that the left navigation (which is the website main navigation) stays high level and only shows titles, leaving the detailed hierarchy in the right navigation, which appears when you click on a Documentation topic or when you land directly on it. You can see a screenshot of the current and proposed designs in the wiki repo with the other website designs [1]. The names of the files are: current_DocsNav for the current design, and proposed_DocsNav for the proposed design. Please let us know your preference or suggestions through this week. Gris [1] https://cwiki.apache.org/confluence/display/BEAM/Website+Redesign+Files