Hi All, Please note that based on the feedback that I received, I reverted to the page tree [1] approach in the left navigation pane. Unfortunately, when having this approach there is no way of maintaining the highlighted section headings.
[1] https://confluence.atlassian.com/display/DOC/Page+Tree+Macro Regards, Mariangela *Mariangela Hills* Senior Technical Writer - WSO2, Inc. http://wso2.com Committer and PMC member - Apache Stratos email:mariang...@wso2.com | mobile: +94 773 500185 On Sun, Jun 21, 2015 at 7:52 AM, Imesh Gunaratne <im...@apache.org> wrote: > Hi Mari/Shavindri, > > Great work on re-designing the navigation menu! > > I understand the technical difficulties we have with Confluence, but I > still think expandable menu is much more user-friendly than the new one as > Lasindu has mentioned. > > Thanks > > On Fri, Jun 19, 2015 at 5:38 PM, Mariangela Hills <mariang...@wso2.com> > wrote: > >> Hi Devs, >> >> Previously, we used the page tree macro to automatically generate the >> navigation pane [1]. This allowed us to view the hierarchy and highlight >> the page being currently viewed. >> >> Wiki Markup needs to be used to customize the left navigation pane. >> Shavindri and myself, have been comparing our docs against competitors and >> researching for ways to improve the look and feel of the documentation, >> while working within the limitations that we have with Confluence. >> >> In Stratos wiki [2] Apache does not allow each product to have their own >> wiki space stylesheet, as a result the customizations that we can on the >> docs are very limited. In addition, in Wiki (Confluence) we can not have >> pages with the same name. Therefore, we have to add a prefix to each page >> name (e.g. 4.0.0 Introduction, 4.1.0 Introduction) to differentiate between >> the docs for the respective released versions. As a result of the latter, >> when we used the page tree tool [1] the structure looked a bit messy and >> cluttered, as the main sections that we have in the docs weren't clear at >> first sight. >> >> Shavindri and I, I have been experimenting with the Wiki Markup language >> to try to improve the new left navigation pane, to take into the aspect >> that Lasidu brought up. However, we haven't been very successful as the >> formatting has been getting affected. It would be great if someone who has >> a spare cycle can give us a small helping hand to see if we can come up >> with a work around. >> >> >> [1] https://confluence.atlassian.com/display/DOC/Page+Tree+Macro >> [2] https://cwiki.apache.org/confluence/display/STRATOS/Home >> >> Regards, >> Mariangela >> >> >> *Mariangela Hills* >> Senior Technical Writer - WSO2, Inc. http://wso2.com >> Committer and PMC member - Apache Stratos >> email:mariang...@wso2.com | mobile: +94 773 500185 >> >> On Fri, Jun 19, 2015 at 3:04 PM, Lasindu Charith <lasi...@wso2.com> >> wrote: >> >>> Hi Mari, >>> >>> +1 for the change & the highlighted heading sections. >>> But it's bit difficult to see where am I while navigating the pages, >>> since it does not show the hierarchy nor highlight the current viewing page >>> in the left pane. >>> >>> Thanks, >>> >>> On Fri, Jun 19, 2015 at 2:32 PM, Mariangela Hills <mariang...@wso2.com> >>> wrote: >>> >>>> Hi Devs, >>>> >>>> Please note that I changed the navigation structure for Stratos 4.1.0. >>>> [1] and archived the Stratos 4.0.0 docs. >>>> >>>> [1] https://cwiki.apache.org/confluence/display/STRATOS/Home >>>> >>>> Regards, >>>> Mariangela >>>> >>>> >>>> *Mariangela Hills* >>>> Senior Technical Writer - WSO2, Inc. http://wso2.com >>>> Committer and PMC member - Apache Stratos >>>> email:mariang...@wso2.com | mobile: +94 773 500185 >>>> >>> >>> >>> >>> -- >>> *Lasindu Charith* >>> Software Engineer, WSO2 Inc. >>> Committer & PMC Member, Apache Stratos >>> Mobile: +94714427192 | Web: blog.lasindu.com >>> >> >> > > > -- > Imesh Gunaratne > > Senior Technical Lead, WSO2 > Committer & PMC Member, Apache Stratos >
