Re: Apache Geronimo Knowledge Base (was: Wiki based FAQ)
Done.
--jason
On Jun 22, 2006, at 9:01 PM, Prasad Kashyap wrote:
Cool Jason. I like it. Can we please have to/fro links from the
http://cwiki.apache.org/geronimo site to the KB.
Thanx
Prasad
On 6/22/06, Jason Dillon <[EMAIL PROTECTED]> wrote:
Autoexport is up:
http://cwiki.apache.org/GMOxKB/index.html
--jason
On Jun 22, 2006, at 12:17 PM, Jason Dillon wrote:
> Okay, here ya go:
>
> http://cwiki.apache.org/confluence/display/GMOxKB
>
> I did a few things...
>
> First, I setup a geronimo team label, and labeled all of our spaces
> (so from the dashboard you can see all of the G-related spaces
> easily). New spaces for G should also get this label added (have
> add it manually after creation).
>
> Then I added a {font-size} user-macro to help change font sizes.
>
> I installed the navigation plugin (which gets us {scrollbar}).
>
> I installed the footnotes plugin, see this for an example: http://
> cwiki.apache.org/confluence/display/GMOxKB/CLI
>
> And I installed the plugin repository client, which makes it easier
> to manage plugin versions. I need to know how to get the Utilities
> plugin installed into WEB-INF/lib before I can enable some of the
> other plugins, but that can wait. If you have admin, you can see
> the repository client page here:
>
> http://cwiki.apache.org/confluence/admin/repository/
plugins.action
>
> Just be careful, cause sometimes installing a plugin will hose the
> entire Confluence install, or need it to be bounced before it is
> usable.
>
> Who is the point-man for bouncing/installing stuff for this?
>
> * * *
>
> Basically there are 3 major sections (each of which could really be
> its own space if needed, when we get more content, but for now will
> work):
>
> FAQ - yada yada
> Topics - General KB stuff, not really FAQ
> Glossary - Definitions for terms
>
> The way it works is that each bit of content is its own page. That
> pages parent page is the section it is under. The name of the page
> is the topic title, or FAQ question, or glossary term.
>
> Each content page has at the top {scrollbar}, so that it is easy to
> navigate between all of the pages in the KB.
>
> Sub-sections are also just pages, but with the {children:all=true}
> macro to allow easy navigation to children. It is important to add
> that, cause the default rendering of children pages at the bottom
> is disabled.
>
> The main indexes are dynamic, so you just have to add a page in the
> right place and presto it updates.
>
> Use the {excerpt} macro to provide a bit more detail that will
> compliment the page title in the listing.
>
> * * *
>
> Once we get the Utilities plugin installed into WEB-INF/lib, we can
> use the Zones plugin to setup dynamic templates for each of these
> sections, and then you don't have to worry about the {scrollbar} or
> {children} stuff, just add the content and the zone will render per
> the zone template.
>
> I have not yet set this up to auto-export, should probably do that
> soon.
>
> * * *
>
> Comments? Questions? Yada yada...
>
> --jason
>
Re: Apache Geronimo Knowledge Base (was: Wiki based FAQ)
Cool Jason. I like it. Can we please have to/fro links from the
http://cwiki.apache.org/geronimo site to the KB.
Thanx
Prasad
On 6/22/06, Jason Dillon <[EMAIL PROTECTED]> wrote:
Autoexport is up:
http://cwiki.apache.org/GMOxKB/index.html
--jason
On Jun 22, 2006, at 12:17 PM, Jason Dillon wrote:
> Okay, here ya go:
>
> http://cwiki.apache.org/confluence/display/GMOxKB
>
> I did a few things...
>
> First, I setup a geronimo team label, and labeled all of our spaces
> (so from the dashboard you can see all of the G-related spaces
> easily). New spaces for G should also get this label added (have
> add it manually after creation).
>
> Then I added a {font-size} user-macro to help change font sizes.
>
> I installed the navigation plugin (which gets us {scrollbar}).
>
> I installed the footnotes plugin, see this for an example: http://
> cwiki.apache.org/confluence/display/GMOxKB/CLI
>
> And I installed the plugin repository client, which makes it easier
> to manage plugin versions. I need to know how to get the Utilities
> plugin installed into WEB-INF/lib before I can enable some of the
> other plugins, but that can wait. If you have admin, you can see
> the repository client page here:
>
> http://cwiki.apache.org/confluence/admin/repository/plugins.action
>
> Just be careful, cause sometimes installing a plugin will hose the
> entire Confluence install, or need it to be bounced before it is
> usable.
>
> Who is the point-man for bouncing/installing stuff for this?
>
> * * *
>
> Basically there are 3 major sections (each of which could really be
> its own space if needed, when we get more content, but for now will
> work):
>
> FAQ - yada yada
> Topics - General KB stuff, not really FAQ
> Glossary - Definitions for terms
>
> The way it works is that each bit of content is its own page. That
> pages parent page is the section it is under. The name of the page
> is the topic title, or FAQ question, or glossary term.
>
> Each content page has at the top {scrollbar}, so that it is easy to
> navigate between all of the pages in the KB.
>
> Sub-sections are also just pages, but with the {children:all=true}
> macro to allow easy navigation to children. It is important to add
> that, cause the default rendering of children pages at the bottom
> is disabled.
>
> The main indexes are dynamic, so you just have to add a page in the
> right place and presto it updates.
>
> Use the {excerpt} macro to provide a bit more detail that will
> compliment the page title in the listing.
>
> * * *
>
> Once we get the Utilities plugin installed into WEB-INF/lib, we can
> use the Zones plugin to setup dynamic templates for each of these
> sections, and then you don't have to worry about the {scrollbar} or
> {children} stuff, just add the content and the zone will render per
> the zone template.
>
> I have not yet set this up to auto-export, should probably do that
> soon.
>
> * * *
>
> Comments? Questions? Yada yada...
>
> --jason
>
Re: Apache Geronimo Knowledge Base (was: Wiki based FAQ)
Autoexport is up:
http://cwiki.apache.org/GMOxKB/index.html
--jason
On Jun 22, 2006, at 12:17 PM, Jason Dillon wrote:
Okay, here ya go:
http://cwiki.apache.org/confluence/display/GMOxKB
I did a few things...
First, I setup a geronimo team label, and labeled all of our spaces
(so from the dashboard you can see all of the G-related spaces
easily). New spaces for G should also get this label added (have
add it manually after creation).
Then I added a {font-size} user-macro to help change font sizes.
I installed the navigation plugin (which gets us {scrollbar}).
I installed the footnotes plugin, see this for an example: http://
cwiki.apache.org/confluence/display/GMOxKB/CLI
And I installed the plugin repository client, which makes it easier
to manage plugin versions. I need to know how to get the Utilities
plugin installed into WEB-INF/lib before I can enable some of the
other plugins, but that can wait. If you have admin, you can see
the repository client page here:
http://cwiki.apache.org/confluence/admin/repository/plugins.action
Just be careful, cause sometimes installing a plugin will hose the
entire Confluence install, or need it to be bounced before it is
usable.
Who is the point-man for bouncing/installing stuff for this?
* * *
Basically there are 3 major sections (each of which could really be
its own space if needed, when we get more content, but for now will
work):
FAQ - yada yada
Topics - General KB stuff, not really FAQ
Glossary - Definitions for terms
The way it works is that each bit of content is its own page. That
pages parent page is the section it is under. The name of the page
is the topic title, or FAQ question, or glossary term.
Each content page has at the top {scrollbar}, so that it is easy to
navigate between all of the pages in the KB.
Sub-sections are also just pages, but with the {children:all=true}
macro to allow easy navigation to children. It is important to add
that, cause the default rendering of children pages at the bottom
is disabled.
The main indexes are dynamic, so you just have to add a page in the
right place and presto it updates.
Use the {excerpt} macro to provide a bit more detail that will
compliment the page title in the listing.
* * *
Once we get the Utilities plugin installed into WEB-INF/lib, we can
use the Zones plugin to setup dynamic templates for each of these
sections, and then you don't have to worry about the {scrollbar} or
{children} stuff, just add the content and the zone will render per
the zone template.
I have not yet set this up to auto-export, should probably do that
soon.
* * *
Comments? Questions? Yada yada...
--jason
Apache Geronimo Knowledge Base (was: Wiki based FAQ)
Okay, here ya go:
http://cwiki.apache.org/confluence/display/GMOxKB
I did a few things...
First, I setup a geronimo team label, and labeled all of our spaces
(so from the dashboard you can see all of the G-related spaces
easily). New spaces for G should also get this label added (have add
it manually after creation).
Then I added a {font-size} user-macro to help change font sizes.
I installed the navigation plugin (which gets us {scrollbar}).
I installed the footnotes plugin, see this for an example: http://
cwiki.apache.org/confluence/display/GMOxKB/CLI
And I installed the plugin repository client, which makes it easier
to manage plugin versions. I need to know how to get the Utilities
plugin installed into WEB-INF/lib before I can enable some of the
other plugins, but that can wait. If you have admin, you can see the
repository client page here:
http://cwiki.apache.org/confluence/admin/repository/plugins.action
Just be careful, cause sometimes installing a plugin will hose the
entire Confluence install, or need it to be bounced before it is usable.
Who is the point-man for bouncing/installing stuff for this?
* * *
Basically there are 3 major sections (each of which could really be
its own space if needed, when we get more content, but for now will
work):
FAQ - yada yada
Topics - General KB stuff, not really FAQ
Glossary - Definitions for terms
The way it works is that each bit of content is its own page. That
pages parent page is the section it is under. The name of the page
is the topic title, or FAQ question, or glossary term.
Each content page has at the top {scrollbar}, so that it is easy to
navigate between all of the pages in the KB.
Sub-sections are also just pages, but with the {children:all=true}
macro to allow easy navigation to children. It is important to add
that, cause the default rendering of children pages at the bottom is
disabled.
The main indexes are dynamic, so you just have to add a page in the
right place and presto it updates.
Use the {excerpt} macro to provide a bit more detail that will
compliment the page title in the listing.
* * *
Once we get the Utilities plugin installed into WEB-INF/lib, we can
use the Zones plugin to setup dynamic templates for each of these
sections, and then you don't have to worry about the {scrollbar} or
{children} stuff, just add the content and the zone will render per
the zone template.
I have not yet set this up to auto-export, should probably do that soon.
* * *
Comments? Questions? Yada yada...
--jason
Re: Wiki based FAQ
Sure, maybe have something to look at later this week.--jasonOn 6/20/06, Dain Sundstrom <[EMAIL PROTECTED]
> wrote:Sounds cool. Can you setup a demo?-dainOn Jun 19, 2006, at 7:33 PM, Jason Dillon wrote:
> +1>> I think that this is a good idea. I setup a wiki-based Knowledge> Base at my previous company in Confluence and it really helped to> collect and spread knowledge.>
> For this to work in Confluence it should have its own space, like> GMOxKB. It also works really well when using the {excerpt} macro> to give the TOC more context, and the {scrollbar} macro to make it
> easier to navigate through pages in the KB.>> --jason>>> On Jun 16, 2006, at 3:19 PM, Dain Sundstrom wrote:>>> I put together a FAQ in the sandbox on the cwiki. I seeded it
>> with content from the main wiki on the Geronimo website and with>> some content from a resent email I sent about accessing an MBean>> server from a GBean. This is just an idea, and I will have no hard feelings if we
>> decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ
What do you think? -dain
Re: Wiki based FAQ
Sounds cool. Can you setup a demo?
-dain
On Jun 19, 2006, at 7:33 PM, Jason Dillon wrote:
+1
I think that this is a good idea. I setup a wiki-based Knowledge
Base at my previous company in Confluence and it really helped to
collect and spread knowledge.
For this to work in Confluence it should have its own space, like
GMOxKB. It also works really well when using the {excerpt} macro
to give the TOC more context, and the {scrollbar} macro to make it
easier to navigate through pages in the KB.
--jason
On Jun 16, 2006, at 3:19 PM, Dain Sundstrom wrote:
I put together a FAQ in the sandbox on the cwiki. I seeded it
with content from the main wiki on the Geronimo website and with
some content from a resent email I sent about accessing an MBean
server from a GBean.
This is just an idea, and I will have no hard feelings if we
decide to delete it (it only took 20 minutes to get going).
http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ
What do you think?
-dain
Re: Wiki based FAQ
+1
I think that this is a good idea. I setup a wiki-based Knowledge
Base at my previous company in Confluence and it really helped to
collect and spread knowledge.
For this to work in Confluence it should have its own space, like
GMOxKB. It also works really well when using the {excerpt} macro to
give the TOC more context, and the {scrollbar} macro to make it
easier to navigate through pages in the KB.
--jason
On Jun 16, 2006, at 3:19 PM, Dain Sundstrom wrote:
I put together a FAQ in the sandbox on the cwiki. I seeded it with
content from the main wiki on the Geronimo website and with some
content from a resent email I sent about accessing an MBean server
from a GBean.
This is just an idea, and I will have no hard feelings if we decide
to delete it (it only took 20 minutes to get going).
http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ
What do you think?
-dain
Re: Wiki based FAQ
On Jun 19, 2006, at 2:27 PM, Hernan Cunico wrote: Jacek Laskowski wrote: On 6/17/06, Dain Sundstrom <[EMAIL PROTECTED]> wrote: I put together a FAQ in the sandbox on the cwiki. I seeded it with content from the main wiki on the Geronimo website and with some content from a resent email I sent about accessing an MBean server from a GBean. This is just an idea, and I will have no hard feelings if we decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ What do you think? The more places one can contribute the better. Documentation is always a big PITA for open source projects so I don't worry about its existence. It will survive, esp. now when editing is so easy to do. I wonder why the name is so...well...different? How was it chosen? cwiki.apache.org was decided with the infraestructure folks. Dain included the direct link to confluence but we now have an customized HTML version that gets updated automatically everytime a page is edited. So, to access the wiki you should just typen cwiki.apache.org/geronimo Duh :) I forgot about the exporting. You can find the page directly here: http://cwiki.apache.org/GMOxSBOX/faq.html -dain
Re: Wiki based FAQ
Jacek Laskowski wrote: On 6/17/06, Dain Sundstrom <[EMAIL PROTECTED]> wrote: I put together a FAQ in the sandbox on the cwiki. I seeded it with content from the main wiki on the Geronimo website and with some content from a resent email I sent about accessing an MBean server from a GBean. This is just an idea, and I will have no hard feelings if we decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ What do you think? The more places one can contribute the better. Documentation is always a big PITA for open source projects so I don't worry about its existence. It will survive, esp. now when editing is so easy to do. I wonder why the name is so...well...different? How was it chosen? cwiki.apache.org was decided with the infraestructure folks. Dain included the direct link to confluence but we now have an customized HTML version that gets updated automatically everytime a page is edited. So, to access the wiki you should just typen cwiki.apache.org/geronimo Does that answer your question about the name? Cheers! Hernan +1 -dain Jacek
Re: Wiki based FAQ
On 6/17/06, Dain Sundstrom <[EMAIL PROTECTED]> wrote: I put together a FAQ in the sandbox on the cwiki. I seeded it with content from the main wiki on the Geronimo website and with some content from a resent email I sent about accessing an MBean server from a GBean. This is just an idea, and I will have no hard feelings if we decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ What do you think? The more places one can contribute the better. Documentation is always a big PITA for open source projects so I don't worry about its existence. It will survive, esp. now when editing is so easy to do. I wonder why the name is so...well...different? How was it chosen? +1 -dain Jacek -- Jacek Laskowski http://www.laskowski.net.pl
Re: Wiki based FAQ
+1 On Jun 16, 2006, at 6:19 PM, Dain Sundstrom wrote: I put together a FAQ in the sandbox on the cwiki. I seeded it with content from the main wiki on the Geronimo website and with some content from a resent email I sent about accessing an MBean server from a GBean. This is just an idea, and I will have no hard feelings if we decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ What do you think? -dain -sachin
Wiki based FAQ
I put together a FAQ in the sandbox on the cwiki. I seeded it with content from the main wiki on the Geronimo website and with some content from a resent email I sent about accessing an MBean server from a GBean. This is just an idea, and I will have no hard feelings if we decide to delete it (it only took 20 minutes to get going). http://cwiki.apache.org/confluence/display/GMOxSBOX/FAQ What do you think? -dain
