On 07.04.2011, at 07:07, Reto Bachmann-Gmuer wrote: Hi Marco,
Even when you're not a developer you're free to proposes patches to the website publication process as well as to the website content itself. It is requirement on a process however that all content is stored in svn, so simple SFTP isn't an option. That already is a NOGO for a non-techie. Storing data in svn, fine. But a non-techie does not work with such tools. Actually even SFTP would already be challenging. That's why wikis and other CMS should be used in the mid-term. Also keep in mind that documentation should mainly be available in the documentation both published on the website as well as being available online on a clerezza instance. So the process should take this into account. Agree with that, I think I'm not writing technical documentation, but rather the content around that, be it use cases, solutions that already use Clerezza, acknowledgments, non-tech summaries etc. I personally doubt that this type of information is needed in a Clerezza instance. As mentioned in an earlier mauil to the subject, you're also welcome to raise issues against the current content, this issues may be accompanied by a patch but may also just describe the typo in the text. Even for the technical audience the content needs to be revisited, the start page advertises a non existent front end adaptor for the sesame api. Quite a time-consuming and unpractical way. If one would like to build the page using different styling options etc. you need whether a cms or simple html/css/javascript structure you can modify in a text editor or Dreamweaver. If Henry and co. would like to push Clerezza out to invite developers and advanced users to use it, we have to talk their language. And the content should be actually written by people that understands their needs. That's the beauty of a open source community, different people with different backgrounds and skills can share their time and experience for a greater good. But hey, if you don't need us and write everything yourself, bon. No problem. But if you need us you have to compromise. Reto On Thu, Apr 7, 2011 at 5:53 AM, Marco Zaugg <[email protected]<mailto:[email protected]>> wrote: Hi there I'd like to contribute my non-techie time to work on the project website http://incubator.apache.org/clerezza/ as the current site contains many typos, missing content for IT executives, Non-SemWeb savvies etc. Although not usual in the developer world I thought even contributing summaries of what Apache Clerezza is about in different languages. Question: How do I modify the content without being a Clerezza Core developer. I'm looking for whether a simple SSH/SFTP access to HTML files or a simple CMS that I can use to populate the content. Of course somebody of the core team will have to approve the content. In order to improve the speed of developer howtos and further documentation I would rather use a wiki such as Confluence or similar. My company is partner of Atlassian and therefore able to provide a customized Apache Clerezza Wiki skin. I challenge the current process of updating content as it seems to be too time consuming and over-engineered for what the community need. If you want good quality documentation you have to lower the hurdles for those that are willing to contribute. If you'd like to showcase the capabilities of Apache Clerezza don't do that jeopardizing the easyness of updating content. This actually is one of the leasons learned in the knowledge management world that came out with wikis as one of the answers to that. Marco
