Dear Ben and Steve,
I think that once the wiki is at least fed by the docs,
the docs space should link directly to the wiki,
to avoid duplication...
The purpose of the wiki is to get more people involved in the doc,
and hopefully to get a more up-to-date doc,
and I would say : to prevent experts from repeating themselves years
after years in the mailing lists...
So if the wiki succeeds to be more complete than the present doc, it
"should" replace it.
If it fails...it will disappear...
By the mechanism of "administrators" of the wiki, it may be possible to
restrict modifications of some core docs coming from the dev team,
to the dev team.
And to allow adds at the end of the core chapters as "comments"...by
ordinary contributors...
Just to mention: I do NOT think that the wiki should have any
"openssl-dev" purpose : only a purpose to "use" openssl.
I mean that dev-team should have its own doc space as usual, away from
the wiki.
Yours sincerely,
Pierre
Le 19/03/2013 20:15, Ben Laurie a écrit :
On 19 March 2013 18:53, Steve Marquess <marqu...@opensslfoundation.com> wrote:
On 03/19/2013 10:47 AM, Pierre DELAAGE wrote:
Dear Steve, I was wondering whether the wiki could be "fed" at the
beginning by all the Documents available at
"http://www.openssl.org/docs/";.
Very often people are able to comment, eg, a command page with some
samples or error comments, instead of rewriting from scratch a "man
page".
And this could be a way to only have one unique set of docs to
maintain, and to refer to, instead of having two...
That's an interesting suggestion; I'll kick it around and see what kind
of traction it gets.
Seems like a good idea to me. It does raise the question of how you
export back to the docs tho...
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List openssl-dev@openssl.org
Automated List Manager majord...@openssl.org
