Re: Geronimo documentation architecture
Very cool plugin !!! (a bit slow though ;-) ) Personal preference, I like better attaching the graphics I create with Open Office. I can download and edit them with any editor, plus I keep a bkp. I'll update the guidelines and include some tips for the graphics. Cheers! Hernan Jason Dillon wrote: FYI, more info on Giffy here: http://confluence.atlassian.com/display/CONFEXT/Gliffy+Plugin+for+Confluence+-+Diagram+and+draw+in+Confluence and here: http://www.gliffy.com/ --jason On Feb 10, 2007, at 9:04 PM, Jason Dillon wrote: FYI, cwiki has Giffy installed on it... so you can use that to create diagrams too. See the "Add Diagram" link when looking at a page under http://cwiki.apache.org/confluence/... --jason On Feb 10, 2007, at 8:57 PM, Kanchana Welagedara wrote: Hi Hernan Everything has nicely put together.Good content Hernan. I think it would be useful for people who wants contribute in writing docs to know tips about drawing diagrams as well (in the section of "Tips for Writing and formatting documentation").Most of the diagrams in Sample applications and deployment plans were used open office/eclipse tools (Since we don't have license software) to draw diagrams.Also we have used geronimo colors(Blue,Black). Regards Kanchana On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: Hi All, I put together two documents explaining how Geronimo's wiki is organized, confluence spaces, HTML auto export plugins, etc. as well as some basic guidelines for formatting the content for the articles that make the actual Geronimo documentation. Documentation architecture: http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation-architecture.html Documentation guidelines: http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting-documentation.html Pls let me know if any of these docs are not clear, there is a lot of room for improvement. The idea behind this is to: 1.- have documented how the Geronimo documentation is organized 2.- provide a standard way to reference specific pages/articles within the documentation 3.- provide text formatting guidelines for consistency all across the documentation. Your comments are very much appreciated. Cheers! Hernan
Re: Geronimo documentation architecture
Oh Yeah! Most definitely!! Regards Karthiga On 2/11/07, Kanchana Welagedara <[EMAIL PROTECTED]> wrote: cool..Thank you very much for your info.. Karthiga good news isn't it? Thanks Kanchana On Sat, 2007-02-10 at 21:11 -0800, Jason Dillon wrote: > FYI, more info on Giffy here: > > http://confluence.atlassian.com/display/CONFEXT/Gliffy+Plugin+for > +Confluence+-+Diagram+and+draw+in+Confluence > > and here: > > http://www.gliffy.com/ > > --jason > > > On Feb 10, 2007, at 9:04 PM, Jason Dillon wrote: > > > FYI, cwiki has Giffy installed on it... so you can use that to > > create diagrams too. See the "Add Diagram" link when looking at a > > page under http://cwiki.apache.org/confluence/... > > > > --jason > > > > > > On Feb 10, 2007, at 8:57 PM, Kanchana Welagedara wrote: > > > >> Hi Hernan > >> > >> Everything has nicely put together.Good content Hernan. > >> I think it would be useful for people who wants contribute in > >> writing > >> docs to know tips about drawing diagrams as well (in the section of > >> "Tips for Writing and formatting documentation").Most of the > >> diagrams in > >> Sample applications and deployment plans were used open office/ > >> eclipse > >> tools (Since we don't have license software) to draw diagrams.Also we > >> have used geronimo colors(Blue,Black). > >> > >> Regards > >> Kanchana > >> > >> On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: > >>> Hi All, > >>> I put together two documents explaining how Geronimo's wiki is > >>> organized, confluence spaces, HTML auto export plugins, etc. as > >>> well as some basic guidelines for formatting the content for the > >>> articles that make the actual Geronimo documentation. > >>> > >>> Documentation architecture: > >>> http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation- > >>> architecture.html > >>> > >>> Documentation guidelines: > >>> http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting- > >>> documentation.html > >>> > >>> Pls let me know if any of these docs are not clear, there is a > >>> lot of room for improvement. > >>> > >>> The idea behind this is to: > >>> > >>> 1.- have documented how the Geronimo documentation is organized > >>> 2.- provide a standard way to reference specific pages/articles > >>> within the documentation > >>> 3.- provide text formatting guidelines for consistency all across > >>> the documentation. > >>> > >>> Your comments are very much appreciated. > >>> > >>> Cheers! > >>> Hernan > >> > > >
Re: Geronimo documentation architecture
cool..Thank you very much for your info.. Karthiga good news isn't it? Thanks Kanchana On Sat, 2007-02-10 at 21:11 -0800, Jason Dillon wrote: > FYI, more info on Giffy here: > > http://confluence.atlassian.com/display/CONFEXT/Gliffy+Plugin+for > +Confluence+-+Diagram+and+draw+in+Confluence > > and here: > > http://www.gliffy.com/ > > --jason > > > On Feb 10, 2007, at 9:04 PM, Jason Dillon wrote: > > > FYI, cwiki has Giffy installed on it... so you can use that to > > create diagrams too. See the "Add Diagram" link when looking at a > > page under http://cwiki.apache.org/confluence/... > > > > --jason > > > > > > On Feb 10, 2007, at 8:57 PM, Kanchana Welagedara wrote: > > > >> Hi Hernan > >> > >> Everything has nicely put together.Good content Hernan. > >> I think it would be useful for people who wants contribute in > >> writing > >> docs to know tips about drawing diagrams as well (in the section of > >> "Tips for Writing and formatting documentation").Most of the > >> diagrams in > >> Sample applications and deployment plans were used open office/ > >> eclipse > >> tools (Since we don't have license software) to draw diagrams.Also we > >> have used geronimo colors(Blue,Black). > >> > >> Regards > >> Kanchana > >> > >> On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: > >>> Hi All, > >>> I put together two documents explaining how Geronimo's wiki is > >>> organized, confluence spaces, HTML auto export plugins, etc. as > >>> well as some basic guidelines for formatting the content for the > >>> articles that make the actual Geronimo documentation. > >>> > >>> Documentation architecture: > >>> http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation- > >>> architecture.html > >>> > >>> Documentation guidelines: > >>> http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting- > >>> documentation.html > >>> > >>> Pls let me know if any of these docs are not clear, there is a > >>> lot of room for improvement. > >>> > >>> The idea behind this is to: > >>> > >>> 1.- have documented how the Geronimo documentation is organized > >>> 2.- provide a standard way to reference specific pages/articles > >>> within the documentation > >>> 3.- provide text formatting guidelines for consistency all across > >>> the documentation. > >>> > >>> Your comments are very much appreciated. > >>> > >>> Cheers! > >>> Hernan > >> > > >
Re: Geronimo documentation architecture
FYI, more info on Giffy here: http://confluence.atlassian.com/display/CONFEXT/Gliffy+Plugin+for +Confluence+-+Diagram+and+draw+in+Confluence and here: http://www.gliffy.com/ --jason On Feb 10, 2007, at 9:04 PM, Jason Dillon wrote: FYI, cwiki has Giffy installed on it... so you can use that to create diagrams too. See the "Add Diagram" link when looking at a page under http://cwiki.apache.org/confluence/... --jason On Feb 10, 2007, at 8:57 PM, Kanchana Welagedara wrote: Hi Hernan Everything has nicely put together.Good content Hernan. I think it would be useful for people who wants contribute in writing docs to know tips about drawing diagrams as well (in the section of "Tips for Writing and formatting documentation").Most of the diagrams in Sample applications and deployment plans were used open office/ eclipse tools (Since we don't have license software) to draw diagrams.Also we have used geronimo colors(Blue,Black). Regards Kanchana On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: Hi All, I put together two documents explaining how Geronimo's wiki is organized, confluence spaces, HTML auto export plugins, etc. as well as some basic guidelines for formatting the content for the articles that make the actual Geronimo documentation. Documentation architecture: http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation- architecture.html Documentation guidelines: http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting- documentation.html Pls let me know if any of these docs are not clear, there is a lot of room for improvement. The idea behind this is to: 1.- have documented how the Geronimo documentation is organized 2.- provide a standard way to reference specific pages/articles within the documentation 3.- provide text formatting guidelines for consistency all across the documentation. Your comments are very much appreciated. Cheers! Hernan
Re: Geronimo documentation architecture
FYI, cwiki has Giffy installed on it... so you can use that to create diagrams too. See the "Add Diagram" link when looking at a page under http://cwiki.apache.org/confluence/... --jason On Feb 10, 2007, at 8:57 PM, Kanchana Welagedara wrote: Hi Hernan Everything has nicely put together.Good content Hernan. I think it would be useful for people who wants contribute in writing docs to know tips about drawing diagrams as well (in the section of "Tips for Writing and formatting documentation").Most of the diagrams in Sample applications and deployment plans were used open office/eclipse tools (Since we don't have license software) to draw diagrams.Also we have used geronimo colors(Blue,Black). Regards Kanchana On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: Hi All, I put together two documents explaining how Geronimo's wiki is organized, confluence spaces, HTML auto export plugins, etc. as well as some basic guidelines for formatting the content for the articles that make the actual Geronimo documentation. Documentation architecture: http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation- architecture.html Documentation guidelines: http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting- documentation.html Pls let me know if any of these docs are not clear, there is a lot of room for improvement. The idea behind this is to: 1.- have documented how the Geronimo documentation is organized 2.- provide a standard way to reference specific pages/articles within the documentation 3.- provide text formatting guidelines for consistency all across the documentation. Your comments are very much appreciated. Cheers! Hernan
Re: Geronimo documentation architecture
Hi Hernan Everything has nicely put together.Good content Hernan. I think it would be useful for people who wants contribute in writing docs to know tips about drawing diagrams as well (in the section of "Tips for Writing and formatting documentation").Most of the diagrams in Sample applications and deployment plans were used open office/eclipse tools (Since we don't have license software) to draw diagrams.Also we have used geronimo colors(Blue,Black). Regards Kanchana On Fri, 2007-02-09 at 14:46 -0500, Hernan Cunico wrote: > Hi All, > I put together two documents explaining how Geronimo's wiki is organized, > confluence spaces, HTML auto export plugins, etc. as well as some basic > guidelines for formatting the content for the articles that make the actual > Geronimo documentation. > > Documentation architecture: > http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation-architecture.html > > Documentation guidelines: > http://cwiki.apache.org/geronimo/tips-for-writing-and-formatting-documentation.html > > Pls let me know if any of these docs are not clear, there is a lot of room > for improvement. > > The idea behind this is to: > > 1.- have documented how the Geronimo documentation is organized > 2.- provide a standard way to reference specific pages/articles within the > documentation > 3.- provide text formatting guidelines for consistency all across the > documentation. > > Your comments are very much appreciated. > > Cheers! > Hernan
