On Sat, Nov 21, 2009 at 1:56 AM, Angela Cymbalak <[email protected]> wrote:
> I like the wiki idea, it seems easier to maintain.  Is there documentation
> available on how to get set up with one?  Do we need to talk to the
> infrastructure folks?

Either Luciano or I can set up a wiki space on Confluence, I believe.

One thing that we should think about is that, if we go with a
Confluence wiki space, we have the option of driving the PhotArk web
site from that too. Right now, our site is based on Anakia, which,
while easy to use, is still not quite as easy as editing a wiki. If we
choose to drive the site from the wiki, the site would be
auto-generated from the wiki pages.

At the risk of confusing people, there are actually two public-facing
sites that we can choose to have:

* The web site. (Required.) This is the "official" site, and
documentation here can be bundled with a release, if we choose to do
that. This site could be Anakia-based, as it is today, or
Confluence-based. It is editable only by committers or (if Confluence)
those who have a signed iCLA on file.

* A public wiki. (Optional.) This can be made editable by anyone, if
we choose, but its contents cannot be bundled with a release, because
that would require signed iCLAs from all contributors.

At this stage, my recommendation would be to go with a web site based
on Confluence, and no public wiki. My reasoning is that (a) using
Confluence for the site makes it very easy to update for all PhotArk
committers and any contributor who is willing to file an iCLA, and (b)
having a wiki as well as a web site will lead to the little
documentation we have being split across two locations, which I think
would hurt our nascent community.

However, that's just my opinion, and it's not up to me, so please,
everyone, let us know what you think. Luciano, especially - I am not
trying to nuke the work you have done to set up the Anakia site!

--
Martin Cooper


> Angie
>
> At 01:15 AM 11/21/2009, Luciano Resende wrote:
>>
>> On Fri, Nov 20, 2009 at 6:12 PM, Angela Cymbalak <[email protected]>
>> wrote:
>> > Luciano,
>> >
>> > I have several pieces of documentation and the logo that I did.  Where
>> > should they be uploaded to?
>> >
>> > Angie
>> >
>>
>> Either to the website, or maybe we should create a wiki ?
>>
>> --
>> Luciano Resende
>> http://people.apache.org/~lresende
>> http://lresende.blogspot.com/
>
>
>

Reply via email to