[xwiki-users] Documentation and code tutorials
Hi all, Just an observation: if there were more documentation, code tutorials i.e. customising the skins, writing macros, writing objects and using them, embedding groovy and velocity code, explaination of snippets of code and how they work, etc then a lot more people would start writing and contributing stuff and it would snowball - so what I'm saying is that a little more work in this area would reap great rewards. Unfortunately I don't know enough of how XWiki works to do this otherwise I'd contribute. Regards, Richard Goldring Thales UK Ltd (Wells) DISCLAIMER: The information contained in this e-mail is confidential. It may also be legally privileged. It is intended only for the stated addressee(s) and access to it by any other person is unauthorised. If you are not an addressee, you must not disclose, copy, circulate or in any other way use or rely on the information contained in this e-mail. Such unauthorised use may be unlawful. We may monitor all e-mail communications through our networks. If you have received this e-mail in error, please inform us immediately on +44 (0) 1749 672081 and delete it and all copies from your system. We accept no responsibility for changes to any e-mail which occur after it has been sent. Attachments to this e-mail may contain software viruses which could damage your system. We therefore recommend you virus-check all attachments before opening. A business of Thales UK Ltd. Registered Office: 2 Dashwood Lang Road, The Bourne Business Park, Addlestone, Weybridge, Surrey KT15 2NX Registered in England No. 868273
Hi Richard, You're definitely right and your help would be greatly appreciated, even a few changes on a page at a time. Since the launch of the new XWiki.org(about 10 months ago) we've been doing our best to improve it. We are aware of the fact that documentation is lacking but at the same time we are hopeful community work will bear its fruits in the end :-) Thanks for your interest in XWiki, I hope to see your contributions soon on XWiki.org :-) Guillaume On 20/09/2007, goldring, richard <[email protected]> wrote:
Hi all,
Just an observation: if there were more documentation, code tutorials i.e. customising the skins, writing macros, writing objects and using them, embedding groovy and velocity code, explaination of snippets of code and how they work, etc then a lot more people would start writing and contributing stuff and it would snowball - so what I'm saying is that a little more work in this area would reap great rewards. Unfortunately I don't know enough of how XWiki works to do this otherwise I'd contribute.
Regards,
Richard Goldring
*Thales UK Ltd (Wells) DISCLAIMER:* The information contained in this e-mail is confidential. It may also be legally privileged. It is intended only for the stated addressee(s) and access to it by any other person is unauthorised. If you are not an addressee, you must not disclose, copy, circulate or in any other way use or rely on the information contained in this e-mail. Such unauthorised use may be unlawful. We may monitor all e-mail communications through our networks. If you have received this e-mail in error, please inform us immediately on +44 (0) 1749 672081 and delete it and all copies from your system. We accept no responsibility for changes to any e-mail which occur after it has been sent. Attachments to this e-mail may contain software viruses which could damage your system. We therefore recommend you virus-check all attachments before opening. A business of Thales UK Ltd. Registered Office: 2 Dashwood Lang Road, The Bourne Business Park, Addlestone, Weybridge, Surrey KT15 2NX Registered in England No. 868273
_______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users
Hi Richard, I definitely agree. Let's do it. Let's all of us do it. This is a simple way for contributors to contribute something too. If each user was putting back was he learns in the documentation then the doc would be awesome. They all say they don't have enough knowledge but since most of them get their stuff working, I assume that they get that knowledge in the end (from the source code, from the answers on the list, etc). Apparently it's easier for them to ask questions and then go away than writing down what they've learnt... So yes current xwiki committers need to do their work but it'd be also good for users and possibly power users to help too :) Let's all work on improving it! Thanks -Vincent On Sep 20, 2007, at 11:20 AM, goldring, richard wrote:
Hi all,
Just an observation: if there were more documentation, code tutorials i.e. customising the skins, writing macros, writing objects and using them, embedding groovy and velocity code, explaination of snippets of code and how they work, etc then a lot more people would start writing and contributing stuff and it would snowball - so what I'm saying is that a little more work in this area would reap great rewards. Unfortunately I don't know enough of how XWiki works to do this otherwise I'd contribute.
Regards,
Richard Goldring
participants (3)
-
goldring, richard -
Guillaume Lerouge -
Vincent Massol