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
