Re: Why http://cwiki.apache.org/GMOxSAMPLES/index.html ?
On Jun 9, 2008, at 4:02 PM, Hernan Cunico wrote: David Jencks wrote: On Jun 9, 2008, at 2:14 PM, Hernan Cunico wrote: I just re exported that GMOxSAMPLES space and now it should reflect the latest updates from the other spaces The idea of this space was to have consolidated in one place references (either links or the actual samples) for all the samples available for Geronimo. This idea is prior to moving all samples to svn or even using the templates for a consistent look and feel. Creating this space was simply the first step towards standardizing the samples. The way Confluence and the autoexport plugin works force us to run manual exports of certain spaces. So far, we don't have a way to get this automated. I would definitively not remove this space as it hold several sample applications. As to adding a page telling where to look, that should be addressed now with the manual export I just ran. Pls let me know if you still see content out of date. The list of samples for 2.1 does not resemble http://cwiki.apache.org/GMOxDOC21/sample-applications.html very closely as far as I can tell. because it is not supposed to do so, it's supposed to list all (mostly children pages) sample applications available for Geronimo organized by release. Looks like my browser was caching an old version, reloading the page looks more like what I expect. I still think two links directly into the 2.1 docs will be more maintainable than a page in the samples space that will require re-export anytime we add/remove a sample or tutorial. thanks david jencks Instead of the link to the apparently-impossible-to-update http://cwiki.apache.org/GMOxSAMPLES/apache-geronimo-v21-samples.html could the top level page http://cwiki.apache.org/GMOxSAMPLES/index.html just have links into the 2.1 documentation for samples and tutorials? the purpose of this space was to consolidate all samples for all releases. If it would be just for 2.1 then there would make no sense to keep this space. Maybe we should consider different alternatives to the AE plugin to generate a personalized HTML version. Long time ago we discussed about expanding Hockey Pokey functionality with Jason Dillon, can't really remember were we left the conversation. I think we have more documentation and general doc infrastructure than we can take care of, and I'd like to see us concentrate more on correctness than size and flashy features. Having fewer confluence spaces with content seems to me like one place to start. I agree with with for the most part. http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation-architecture.html shows 15 spaces and their descriptions. 8 of them are exclusively dedicated to server documentation by release (geronimo, GMOxDOC10..21, plus translations) 1 for authoring the web site (GMOxSITE) 1 for TCK matters (GMOxTCK) 1 for keep track of what we do (GMOxPMGT) 1 for Geronimo development and building (GMOxDEV). Could use some housekeeping 1 for FAQ (GMOxKB). Not many updates lately. 1 documentation sandbox (GMOxSBOX) 1 for holding/consolidating all samples (GMOxSAMPLES) I'm not sure which one I would nuke if I have to. The fact is that this list will continue to grow as we deliver new releases. I don't really see unnecessary spaces. I totally agree with you in focusing on the content (relevance and accuracy). For 2.1 doc I saw a lot more folks chiming in, so a big thanks to everybody who looked into it. If we make this a habit, keeping the doc complete and up to date will be a lot easier. Cheers! Hernan thanks david jencks Cheers! Hernan David Jencks wrote: I'm mystified why there is a separate confluence space for geronimo samples. IIUC the actual sample doc is with the separate servers. Could we eliminate this space or just put a page there saying where to look? The link from http://cwiki.apache.org/GMOxSAMPLES/index.html to the 2.1 samples has inaccurate content that doesn't duplicate the more-correct page in the 2.1 docs. thanks david jencks
Re: Why http://cwiki.apache.org/GMOxSAMPLES/index.html ?
David Jencks wrote: On Jun 9, 2008, at 2:14 PM, Hernan Cunico wrote: I just re exported that GMOxSAMPLES space and now it should reflect the latest updates from the other spaces The idea of this space was to have consolidated in one place references (either links or the actual samples) for all the samples available for Geronimo. This idea is prior to moving all samples to svn or even using the templates for a consistent look and feel. Creating this space was simply the first step towards standardizing the samples. The way Confluence and the autoexport plugin works force us to run manual exports of certain spaces. So far, we don't have a way to get this automated. I would definitively not remove this space as it hold several sample applications. As to adding a page telling where to look, that should be addressed now with the manual export I just ran. Pls let me know if you still see content out of date. The list of samples for 2.1 does not resemble http://cwiki.apache.org/GMOxDOC21/sample-applications.html very closely as far as I can tell. because it is not supposed to do so, it's supposed to list all (mostly children pages) sample applications available for Geronimo organized by release. Instead of the link to the apparently-impossible-to-update http://cwiki.apache.org/GMOxSAMPLES/apache-geronimo-v21-samples.html could the top level page http://cwiki.apache.org/GMOxSAMPLES/index.html just have links into the 2.1 documentation for samples and tutorials? the purpose of this space was to consolidate all samples for all releases. If it would be just for 2.1 then there would make no sense to keep this space. Maybe we should consider different alternatives to the AE plugin to generate a personalized HTML version. Long time ago we discussed about expanding Hockey Pokey functionality with Jason Dillon, can't really remember were we left the conversation. I think we have more documentation and general doc infrastructure than we can take care of, and I'd like to see us concentrate more on correctness than size and flashy features. Having fewer confluence spaces with content seems to me like one place to start. I agree with with for the most part. http://cwiki.apache.org/geronimo/geronimo-cwiki-documentation-architecture.html shows 15 spaces and their descriptions. 8 of them are exclusively dedicated to server documentation by release (geronimo, GMOxDOC10..21, plus translations) 1 for authoring the web site (GMOxSITE) 1 for TCK matters (GMOxTCK) 1 for keep track of what we do (GMOxPMGT) 1 for Geronimo development and building (GMOxDEV). Could use some housekeeping 1 for FAQ (GMOxKB). Not many updates lately. 1 documentation sandbox (GMOxSBOX) 1 for holding/consolidating all samples (GMOxSAMPLES) I'm not sure which one I would nuke if I have to. The fact is that this list will continue to grow as we deliver new releases. I don't really see unnecessary spaces. I totally agree with you in focusing on the content (relevance and accuracy). For 2.1 doc I saw a lot more folks chiming in, so a big thanks to everybody who looked into it. If we make this a habit, keeping the doc complete and up to date will be a lot easier. Cheers! Hernan thanks david jencks Cheers! Hernan David Jencks wrote: I'm mystified why there is a separate confluence space for geronimo samples. IIUC the actual sample doc is with the separate servers. Could we eliminate this space or just put a page there saying where to look? The link from http://cwiki.apache.org/GMOxSAMPLES/index.html to the 2.1 samples has inaccurate content that doesn't duplicate the more-correct page in the 2.1 docs. thanks david jencks
Re: Why http://cwiki.apache.org/GMOxSAMPLES/index.html ?
On Jun 9, 2008, at 2:14 PM, Hernan Cunico wrote: I just re exported that GMOxSAMPLES space and now it should reflect the latest updates from the other spaces The idea of this space was to have consolidated in one place references (either links or the actual samples) for all the samples available for Geronimo. This idea is prior to moving all samples to svn or even using the templates for a consistent look and feel. Creating this space was simply the first step towards standardizing the samples. The way Confluence and the autoexport plugin works force us to run manual exports of certain spaces. So far, we don't have a way to get this automated. I would definitively not remove this space as it hold several sample applications. As to adding a page telling where to look, that should be addressed now with the manual export I just ran. Pls let me know if you still see content out of date. The list of samples for 2.1 does not resemble http://cwiki.apache.org/GMOxDOC21/sample-applications.html very closely as far as I can tell. Instead of the link to the apparently-impossible-to-update http://cwiki.apache.org/GMOxSAMPLES/apache-geronimo-v21-samples.html could the top level page http://cwiki.apache.org/GMOxSAMPLES/index.html just have links into the 2.1 documentation for samples and tutorials? Maybe we should consider different alternatives to the AE plugin to generate a personalized HTML version. Long time ago we discussed about expanding Hockey Pokey functionality with Jason Dillon, can't really remember were we left the conversation. I think we have more documentation and general doc infrastructure than we can take care of, and I'd like to see us concentrate more on correctness than size and flashy features. Having fewer confluence spaces with content seems to me like one place to start. thanks david jencks Cheers! Hernan David Jencks wrote: I'm mystified why there is a separate confluence space for geronimo samples. IIUC the actual sample doc is with the separate servers. Could we eliminate this space or just put a page there saying where to look? The link from http://cwiki.apache.org/GMOxSAMPLES/index.html to the 2.1 samples has inaccurate content that doesn't duplicate the more-correct page in the 2.1 docs. thanks david jencks
Re: Why http://cwiki.apache.org/GMOxSAMPLES/index.html ?
I just re exported that GMOxSAMPLES space and now it should reflect the latest updates from the other spaces The idea of this space was to have consolidated in one place references (either links or the actual samples) for all the samples available for Geronimo. This idea is prior to moving all samples to svn or even using the templates for a consistent look and feel. Creating this space was simply the first step towards standardizing the samples. The way Confluence and the autoexport plugin works force us to run manual exports of certain spaces. So far, we don't have a way to get this automated. I would definitively not remove this space as it hold several sample applications. As to adding a page telling where to look, that should be addressed now with the manual export I just ran. Pls let me know if you still see content out of date. Maybe we should consider different alternatives to the AE plugin to generate a personalized HTML version. Long time ago we discussed about expanding Hockey Pokey functionality with Jason Dillon, can't really remember were we left the conversation. Cheers! Hernan David Jencks wrote: I'm mystified why there is a separate confluence space for geronimo samples. IIUC the actual sample doc is with the separate servers. Could we eliminate this space or just put a page there saying where to look? The link from http://cwiki.apache.org/GMOxSAMPLES/index.html to the 2.1 samples has inaccurate content that doesn't duplicate the more-correct page in the 2.1 docs. thanks david jencks
