[xwiki-devs] [Proposal] - Adding a "Getting Started" space in the default XWiki Enterprise XAR
Hi, Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content. Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents: - What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki) Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance. Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote? If the idea is accepted I'll handle the technical details with JV & Ludo. Thanks, Guillaume -- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
I'm definitely +1 with the idea. Now I'm not sure about having a dedicated GettingStarted space for it. I'd rather see these page(s) in space Main/ or Sandbox/ Jerome. Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Good idea. Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE. -Vincent On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
Hi, On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net> wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
Here are the pages I plan on writing in the Getting Started guide: 1. What's a wiki? 2. What can a wiki be used for? 3. What's special about XWiki Enterprise? 4. First steps with XWiki Enterprise 1. Admins 1. Changing the logo & moving the panels around 2. Creating new users 3. Setting user rights 2. Users 1. Editing a page 2. Creating links & new pages 3. Rollbacking to a previous version of a page 5. Going further: link to relevant sections on XWiki.org WDYT? Guillaume On Fri, Jan 30, 2009 at 2:35 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
Hi,
On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net>wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
You can see what I've done so far here, I'll keep working on it on monday. Is there a specific set of criteria I need to follow to have this considered for inclusion in XE? Thanks, Guillaume On Fri, Jan 30, 2009 at 3:01 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
Here are the pages I plan on writing in the Getting Started guide:
1. What's a wiki? 2. What can a wiki be used for? 3. What's special about XWiki Enterprise? 4. First steps with XWiki Enterprise 1. Admins 1. Changing the logo & moving the panels around 2. Creating new users 3. Setting user rights 2. Users 1. Editing a page 2. Creating links & new pages 3. Rollbacking to a previous version of a page 5. Going further: link to relevant sections on XWiki.org
WDYT?
Guillaume On Fri, Jan 30, 2009 at 2:35 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
Hi,
On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net>wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
On Fri, Jan 30, 2009 at 6:14 PM, Guillaume Lerouge <guillaume@xwiki.com> wrote:
You can see what I've done so far here, I'll keep working on it on monday.
The link is http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/
Is there a specific set of criteria I need to follow to have this considered for inclusion in XE?
Thanks,
Guillaume
On Fri, Jan 30, 2009 at 3:01 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
Here are the pages I plan on writing in the Getting Started guide:
1. What's a wiki? 2. What can a wiki be used for? 3. What's special about XWiki Enterprise? 4. First steps with XWiki Enterprise 1. Admins 1. Changing the logo & moving the panels around 2. Creating new users 3. Setting user rights 2. Users 1. Editing a page 2. Creating links & new pages 3. Rollbacking to a previous version of a page 5. Going further: link to relevant sections on XWiki.org
WDYT?
Guillaume On Fri, Jan 30, 2009 at 2:35 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
Hi,
On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net>wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/ _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
I'm done with the first version of the getting started guide: http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/ Anybody wants to review it? Guillaume On Fri, Jan 30, 2009 at 6:29 PM, Thomas Mortagne <thomas.mortagne@xwiki.com>wrote:
On Fri, Jan 30, 2009 at 6:14 PM, Guillaume Lerouge <guillaume@xwiki.com> wrote:
You can see what I've done so far here, I'll keep working on it on monday.
The link is http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/
Is there a specific set of criteria I need to follow to have this
considered
for inclusion in XE?
Thanks,
Guillaume
On Fri, Jan 30, 2009 at 3:01 PM, Guillaume Lerouge <guillaume@xwiki.com wrote:
Here are the pages I plan on writing in the Getting Started guide:
1. What's a wiki? 2. What can a wiki be used for? 3. What's special about XWiki Enterprise? 4. First steps with XWiki Enterprise 1. Admins 1. Changing the logo & moving the panels around 2. Creating new users 3. Setting user rights 2. Users 1. Editing a page 2. Creating links & new pages 3. Rollbacking to a previous version of a page 5. Going further: link to relevant sections on XWiki.org
WDYT?
Guillaume On Fri, Jan 30, 2009 at 2:35 PM, Guillaume Lerouge <guillaume@xwiki.com wrote:
Hi,
On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
Hi,
Ludovic pointed out to me that many wikis include some kind of tutorial space explaining what a wiki is and how it can be used. I have checked PBWiki & Confluence and both of them include a couple pages explaining what's a wiki. On top of this, the current homepage, which included some information about what a wiki is and what it can be used for, will soon be replaced by a nicer one with way less content.
Thus I'd like to contribute a XAR with 4-5 pages helping new users getting started with our wiki. Here's what I'd envision for the XAR's contents:
- What's a wiki and what can it be used for - Edit a page and create a link - Change your wiki's logo and move the panels around - Protect the wiki (basic rights setup for a couple configurations: public / private wiki)
Basically the first steps most XWiki users will undertake when arriving on a blank XWiki Enterprise instance.
Thus I'd like your PoW on 1) the idea itself & 2) contents to include (keep in mind that this should stay short though). If it's welcomed positively, do I need to send a vote?
If the idea is accepted I'll handle the technical details with JV & Ludo.
Thanks,
Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/ _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
Hi there, I've updated the guide with a new section to cover the items suggested by Helmut (hel-o) in another thread. It's still located at http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/ for now. Do you think it can be considered for inclusion in XE's default XAR as of today? If not, what's still needed? Please keep in mind that: 1. This is only the first version and it will improved later on based on user feedback 2. It needs to be kept short and concise to avoid duplicates with XWiki.org as much as possible 3. It will have to be translated in other languages, thus the shorter the better 4. I need to add more links to relevant pages of XWiki.org in the guide If it's approved, what's the workflow to include it in XE's default XAR ? Thanks, Guillaume On Tue, Feb 3, 2009 at 5:01 PM, Guillaume Lerouge <guillaume@xwiki.com>wrote:
I'm done with the first version of the getting started guide: http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/
Anybody wants to review it?
Guillaume
On Fri, Jan 30, 2009 at 6:29 PM, Thomas Mortagne < thomas.mortagne@xwiki.com> wrote:
On Fri, Jan 30, 2009 at 6:14 PM, Guillaume Lerouge <guillaume@xwiki.com> wrote:
You can see what I've done so far here, I'll keep working on it on monday.
The link is http://enterprise.xwiki.org/xwiki/bin/view/GettingStarted/
Is there a specific set of criteria I need to follow to have this
considered
for inclusion in XE?
Thanks,
Guillaume
On Fri, Jan 30, 2009 at 3:01 PM, Guillaume Lerouge <guillaume@xwiki.com wrote:
Here are the pages I plan on writing in the Getting Started guide:
1. What's a wiki? 2. What can a wiki be used for? 3. What's special about XWiki Enterprise? 4. First steps with XWiki Enterprise 1. Admins 1. Changing the logo & moving the panels around 2. Creating new users 3. Setting user rights 2. Users 1. Editing a page 2. Creating links & new pages 3. Rollbacking to a previous version of a page 5. Going further: link to relevant sections on XWiki.org
WDYT?
Guillaume On Fri, Jan 30, 2009 at 2:35 PM, Guillaume Lerouge < guillaume@xwiki.com>wrote:
Hi,
On Wed, Jan 28, 2009 at 4:10 PM, Vincent Massol <vincent@massol.net wrote:
Good idea.
Idea: maybe we could kill 2 birds with one stone and making this a getting started tutorial that would be on xwiki.org in the user guide and we would package that same tutorial in XE as a default installed application. I really think we shouldn't duplicate the information from xwiki.org but instead package it (or a subset of it - like just the getting started tutorial) inside the default XE.
Sure. I have one question though: if included in XE, this User Guide will have to be available in the wiki's language if it's not english. I can write in a GettingStarted space on enterprise.xwiki.org, but where can I / should I put the translations? At a higher abstraction level: which deployment strategy should we pursue for this? From another wiki to XWiki.org & the default XAR? From XWiki.org to the default XAR? Something else? Guillaume
-Vincent
On Jan 28, 2009, at 3:07 PM, Guillaume Lerouge wrote:
> Hi, > > Ludovic pointed out to me that many wikis include some kind of > tutorial > space explaining what a wiki is and how it can be used. I have checked > PBWiki & Confluence and both of them include a couple pages explaining > what's a wiki. On top of this, the current homepage, which included > some > information about what a wiki is and what it can be used for, will > soon be > replaced by a nicer one with way less content. > > Thus I'd like to contribute a XAR with 4-5 pages helping new users > getting > started with our wiki. Here's what I'd envision for the XAR's > contents: > > - What's a wiki and what can it be used for > - Edit a page and create a link > - Change your wiki's logo and move the panels around > - Protect the wiki (basic rights setup for a couple configurations: > public / private wiki) > > Basically the first steps most XWiki users will undertake when > arriving on a > blank XWiki Enterprise instance. > > Thus I'd like your PoW on 1) the idea itself & 2) contents to > include (keep > in mind that this should stay short though). If it's welcomed > positively, do > I need to send a vote? > > If the idea is accepted I'll handle the technical details with JV & > Ludo. > > Thanks, > > Guillaume
Thanks -Vincent http://xwiki.com http://xwiki.org http://massol.net
_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/ _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/
participants (4)
-
Guillaume Lerouge -
Jerome Velociter -
Thomas Mortagne -
Vincent Massol