On Jun 25, 2012, at 10:53 PM, Charles Moulliard wrote:

> Would you like that I use Apache CMS or that I publish some markdown pages 
> here (http://svn.apache.org/repos/asf/openejb/site/trunk/content/) ?

The Apache CMS is backed by that section of SVN, so it's more or less the same. 
 You don't have direct access and it probably sounds more complicated to 
explain, but in short think github; the CMS allows you to clone the site and 
submit "pull requests".

Basically you just click the little blue pencil icon, edit away, then click 
'Submit' and make sure 'Quick Mail' is selected.

> Do you know if we can use pegdown (https://github.com/sirthias/pegdown) as 
> they support tables ?

At the moment only markdown is supported.

We could certainly switch all the docs over to something else if we wanted to 
do that at the project level, but that would probably be a different discussion 
and we'd need some time to make the CMS be able to handle that format.

> Can we use wiki of confluence ?

Ideally we'd keep driving features into the CMS till people feel they "have 
access" and don't feel compelled to use a wiki or confluence anymore.

So let's definitely use the CMS and definitely feel encouraged to say X, Y or Z 
is a PITA and should be fixed :)


-David


> On 26/06/12 03:56, David Blevins wrote:
>> Hi Charles,
>> 
>> Can you give the new editing links a try?  Not sure we have all the kinks 
>> worked out in terms of existing Apache committers editing docs.  Would love 
>> to use you as a guinea pig to see if we can smooth that process out.
>> 
>> We should probably just give you commit eventually, but I'd love to see if 
>> we can streamline the "ASF contributor" process as well.
>> 
>> Any help in that is greatly appreciated!
>> 
>> 
>> -David
>> 
>> On Jun 13, 2012, at 12:28 AM, Charles Moulliard wrote:
>> 
>>> Hi David,
>>> 
>>> Have you received thoughts after posting this email ?
>>> 
>>> Regards,
>>> 
>>> Charles
>>> 
>>> On Mon, Jun 4, 2012 at 4:29 AM, David Blevins<[email protected]>  
>>> wrote:
>>> Charles had poked me a while back on writing docs for the OSGi support.
>>> 
>>> Currently, writing docs is a matter of sending a patch:
>>> 
>>>  http://svn.apache.org/repos/asf/openejb/site/trunk/content
>>> 
>>> It occurs to me as well that, we have complete control of our svn 
>>> permissions and we could just open up a section of the site for any ASF 
>>> committer to update.
>>> 
>>> Maybe, http://svn.apache.org/repos/asf/openejb/site/trunk/content/contrib/
>>> 
>>> Thoughts?
>>> 
>>> 
>>> -David
>>> 
>>> 

Reply via email to