Please do a to-do list. Documenting is also time consuming as you pointed out but at least I don't know what is needed really, new muckups are being done and I am not sure exactly which work is functional one and which other is 'potential one'.
On Mon, 07 Mar 2005 22:38:51 +0100, :murb: [maarten brouwers] <[EMAIL PROTECTED]> wrote: > Hi, > > Allright, I see what you mean. Documenting the HTML would be possible > already (not much will change), however CSS is little complicated at the > moment, as we're overriding a lot with a third file..., so before > documenting the css files, I'd prefer to wait until most of the job is > done. > > If anyone has time however to start on documenting the HTML code, please > do so, I know it is important, but time is lacking and most of the time > is consumed with discussing already... but i know... these are just the > consequences of collaboration ;) > > g., > > > Maarten > > > Alexandro Colorado wrote: > >> I dont think this is true, I mean you comment while you code so other >> developers >> know what are you coding about specially on things like CSS where you >> can't gess >> where that class or ID is used. So you want to referr which area of the >> site you >> are styling about. >> >> Same as the html, specially if it's XHTML and you want to separate >> content from >> style. >> >> Here is an example of an intent to document the CSS file and result in >> a huge >> file which will take hours to document, simply because the source CSS >> wasn't >> documented (let alone JSP and JS). >> >> Check the document here: >> http://www.openoffice.org/nonav/issues/showattachment.cgi/23157/OpenOffice_Website.odt >> >> >> On Mon, 07 Mar 2005 20:43:08 +0100, :murb: [maarten brouwers] >> <[EMAIL PROTECTED]> >> wrote: >> >> >>> Alexandro Colorado wrote: >>> >>> >>>> Whatever you decided what I really wish is that you comment the code, >>>> whenever >>>> is the CSS code or the HTML/JS. Is really hard getting to document >>>> tigris >>>> because most of the css is code generated so the CSS tree grow >>>> exponentially. >>>> >>>> >>> This will probably be documented, I think kay had already made plans >>> for >>> this ;)? Currently too much is still changing to keep documentation up >>> to date... when close to final documentating stuff should really >>> happen... this was one of the reasons it took us at sc40 so long to get >>> over to actually implementing designs. >>> >>> g., >>> >>> >>> Maarten >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: [EMAIL PROTECTED] >>> For additional commands, e-mail: [EMAIL PROTECTED] >>> >>> >>> >>> >> >> >> >> > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > > -- Alexandro Colorado CoLeader of OpenOffice.org ES http://es.openoffice.org -- Alexandro Colorado Co-Leader of OpenOffice.org Spanish http://es.openoffice.org/ --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
