Sveta, Thanks for help. >+1. If there are no objections, I can add tables of content to longish >pages, such as [2]&[5] Patches are always welcome. Would be great if the tables of content are of unified format. Suggestions: = use TOCHeading and TOC paragraph styles for headings of 1st and 2nd levels respectively = use lists to format the table of contents; if the page has section numbering, an ordered list would be ideal; for unnumbered sections, an unordered list would do. What do you think?
Cheers, Nadya >-----Original Message----- >From: Konovalova, Svetlana [mailto:[EMAIL PROTECTED] >Sent: Thursday, March 15, 2007 10:57 AM >To: [email protected] >Subject: RE: [doc][website]do we need section numeration within pages? > >Alexey, >Thanks a lot for demonstrating interest in this issue! >>I think that all longish pages should have the table, e.g. roadmap [2] >>lacks it. >+1. If there are no objections, I can add tables of content to longish >pages, such as [2]&[5] > >>From maintenance POV, it would be nice to provide automated >>numbering rather than hardcode the digits as a part of contents. >+1. I'll make a research to find the most appropriate solution to this >problem. > >[1] http://harmony.apache.org/subcomponents/drlvm/developers_guide.html >[2] http://harmony.apache.org/roadmap.html >[3] http://harmony.apache.org/subcomponents/classlibrary/awt.html >[4] http://harmony.apache.org/subcomponents/drlvm/JVMTI-PopFrame.html >[5] http://harmony.apache.org/quickhelp_contributors.html > >Best regards, >Sveta >-----Original Message----- >From: Alexey Varlamov [mailto:[EMAIL PROTECTED] >Sent: Thursday, March 15, 2007 8:52 AM >To: [email protected] >Subject: Re: [doc][website]do we need section numeration within pages? > >My $0.02: >1) IMO it is not numbering which makes navigation easier, rather the >table of contents - which is orthogonal issue :) I think that all >longish pages should have the table, e.g. roadmap [2] lacks it. >Numbering is convenient for referencing or citing, which is important >for normative docs like specifications. E.g. I personally don't care >if awt guide [3] has numbering or not, as long as it is well >structured and easy to browse. >2) From maintenance POV, it would be nice to provide automated >numbering rather than hardcode the digits as a part of contents. Bad >example here is roadmap [2], which is inconstant by nature and painful >to keep consistent by hand. >So I'd prefer to not add hardcoded numbering until really needed. > >-- >Thanks, >Alexey > >2007/3/14, Konovalova, Svetlana <[EMAIL PROTECTED]>: >> Dear all, >> I've noticed that certain [1]&[2] pages have numerated sections, and >> certain [3]&[4] don't. >> IMHO, section numeration makes navigation easier. For the sake of >> convenience, you can just say "see section 2.5" instead of saying the >> section name that is probably too long. >> I'd like to ask you whether we need section numeration within pages, >or >> not. >> Could we get rid of this site inconsistency somehow? I'd like to, but >I >> do not insist. :) >> What's your opinion? >> If you do not mind, I volunteer to fix this inconsistency. >> Feel free to express your ideas! Your feedback is very welcome! >> >> [1] >http://harmony.apache.org/subcomponents/drlvm/developers_guide.html >> [2] http://harmony.apache.org/roadmap.html >> [3] http://harmony.apache.org/subcomponents/classlibrary/awt.html >> [4] http://harmony.apache.org/subcomponents/drlvm/JVMTI-PopFrame.html >> >> Thanks, >> Sveta >>
