Re: [xwiki-users] Documentation Guide
> This is very nice. Please merge it with the existing > http://dev.xwiki.org/xwiki/bin/view/Community/Contributing page by > making a children page of it and having it linked from the > Contributing page. done ;) Roman Am Samstag, den 03.10.2009, 13:07 +0200 schrieb Vincent Massol: > On Oct 3, 2009, at 12:26 PM, Roman Friesen wrote: > > > am I only a person, who thinks xwiki needs something like that? > > http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution > > This is very nice. Please merge it with the existing > http://dev.xwiki.org/xwiki/bin/view/Community/Contributing page by > making a children page of it and having it linked from the > Contributing page. > > Thanks! > -Vincent > > > Regards, > > Roman > > > > > > Am Sonntag, den 27.09.2009, 12:26 +0200 schrieb Roman Friesen: > >> Please look at > >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEMainProposal > >> > >> Sometimes I linked to existing pages, sometimes to new drafts/ > >> proposal > >> pages. These are: > >> - How to contribute proposal: > >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEContribute > >> - Documentation proposal: > >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocMain > >> - Documentation Guide proposal: > >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution > >> - User cookbook proposal: > >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocUserCookbook > >> > >> Especially the Documentation Guide is very important, as it defines > >> the > >> way, how the documentation should be worked on. > >> > >> Any feedback would be very appreciated. > >> > >> P.S. > >> 1) My comments are marked as quotes and/or just with italic style. > >> 2) I would thank www.ubuntuusers.de, where I could collect really > >> good > >> documentation experience. > >> > >> Thanks, > >> Roman > >> > >> > >> Am Freitag, den 25.09.2009, 18:19 +0200 schrieb > >> roman.frie...@ropardo.de: > >>> Hello, > >>> > >>> in my opinion, the current xwiki documentation is not optimal in > >>> many > >>> ways: > >>> - not well structured > >>> - not up-to-date > >>> - unclear where/who/how should take care about that (it's for > >>> everyone > >>> editable now, but it doesn't seem to be a really good approach...) > >>> > >>> I would suggest to separate the final documentation and writing of > >>> the > >>> documentation, for example with two spaces: > >>> 1) final docs > >>> - no comments > >>> - editable only for the doc team > >>> 2) staging (writing, reviewing etc.) > >>> - with comments > >>> - editable for all registered users > >>> Among other things (quality), in this way all users can contribute > >>> to > >>> the documentation without having fear to make mistakes. > >>> > >>> If you like, please create a staging space for the Xwiki Enterprise > >>> documentation, then I could start with a basic structure, process > >>> description etc. > >>> > >>> Best regards, > >>> Roman > ___ > users mailing list > users@xwiki.org > http://lists.xwiki.org/mailman/listinfo/users ___ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users
Re: [xwiki-users] Documentation Guide
On Sat, Oct 3, 2009 at 6:07 PM, Vincent Massol wrote: > > On Oct 3, 2009, at 12:26 PM, Roman Friesen wrote: > >> am I only a person, who thinks xwiki needs something like that? >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution > > This is very nice. Please merge it with the existing > http://dev.xwiki.org/xwiki/bin/view/Community/Contributing page by > making a children page of it and having it linked from the > Contributing page. how about make a Table of Content also F ___ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users
Re: [xwiki-users] Documentation Guide
Hi Frans, On Oct 3, 2009, at 12:42 PM, Frans Thamura wrote: > On Sat, Oct 3, 2009 at 5:26 PM, Roman Friesen wrote: >> am I only a person, who thinks xwiki needs something like that? >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution > > > to increase xwiki user, we need documentaiton to use, > > liferay have good documentation, > > i see that xwiki is to complex to learn for new user, and the gap to > become can use, is amazingly hard This is not helping much... If you want to help you can: * Tell us exactly what is missing and where, i.e. when you browsed the doc for a topic, tell us where you've looked, what you've tried and where it has failed. * For topics for which you haven't found answer, help us improve them for the next person who'll need help. Thanks -Vincent ___ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users
Re: [xwiki-users] Documentation Guide
On Oct 3, 2009, at 12:26 PM, Roman Friesen wrote: > am I only a person, who thinks xwiki needs something like that? > http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution This is very nice. Please merge it with the existing http://dev.xwiki.org/xwiki/bin/view/Community/Contributing page by making a children page of it and having it linked from the Contributing page. Thanks! -Vincent > Regards, > Roman > > > Am Sonntag, den 27.09.2009, 12:26 +0200 schrieb Roman Friesen: >> Please look at >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEMainProposal >> >> Sometimes I linked to existing pages, sometimes to new drafts/ >> proposal >> pages. These are: >> - How to contribute proposal: >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEContribute >> - Documentation proposal: >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocMain >> - Documentation Guide proposal: >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution >> - User cookbook proposal: >> http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocUserCookbook >> >> Especially the Documentation Guide is very important, as it defines >> the >> way, how the documentation should be worked on. >> >> Any feedback would be very appreciated. >> >> P.S. >> 1) My comments are marked as quotes and/or just with italic style. >> 2) I would thank www.ubuntuusers.de, where I could collect really >> good >> documentation experience. >> >> Thanks, >> Roman >> >> >> Am Freitag, den 25.09.2009, 18:19 +0200 schrieb >> roman.frie...@ropardo.de: >>> Hello, >>> >>> in my opinion, the current xwiki documentation is not optimal in >>> many >>> ways: >>> - not well structured >>> - not up-to-date >>> - unclear where/who/how should take care about that (it's for >>> everyone >>> editable now, but it doesn't seem to be a really good approach...) >>> >>> I would suggest to separate the final documentation and writing of >>> the >>> documentation, for example with two spaces: >>> 1) final docs >>> - no comments >>> - editable only for the doc team >>> 2) staging (writing, reviewing etc.) >>> - with comments >>> - editable for all registered users >>> Among other things (quality), in this way all users can contribute >>> to >>> the documentation without having fear to make mistakes. >>> >>> If you like, please create a staging space for the Xwiki Enterprise >>> documentation, then I could start with a basic structure, process >>> description etc. >>> >>> Best regards, >>> Roman ___ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users
Re: [xwiki-users] Documentation Guide
On Sat, Oct 3, 2009 at 5:26 PM, Roman Friesen wrote: > am I only a person, who thinks xwiki needs something like that? > http://dev.xwiki.org/xwiki/bin/view/Drafts/XEDocContribution to increase xwiki user, we need documentaiton to use, liferay have good documentation, i see that xwiki is to complex to learn for new user, and the gap to become can use, is amazingly hard F ___ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users