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
