Re: static developer docs

Поиск
Список
Период
Сортировка
От Stefan Kaltenbrunner
Тема Re: static developer docs
Дата
Msg-id 4A27E9AE.9010105@kaltenbrunner.cc
обсуждение исходный текст
Ответ на Re: static developer docs  (Bruce Momjian <bruce@momjian.us>)
Ответы Re: static developer docs  (Bruce Momjian <bruce@momjian.us>)
Список pgsql-www
Bruce Momjian wrote:
> Magnus Hagander wrote:
>> On 4 jun 2009, at 03.21, Bruce Momjian <bruce@momjian.us> wrote:
>>
>>> Dave Page wrote:
>>>> We don't enable the dynamic docs until we go GA.
>>> I think we should have a link to the dynamic URL even during beta so
>>> people patching the docs can see their changes rendered.  The dynamic
>>> build still happens but there is no link to it.
>> That's no what the interactive vs static difference is.
>>
>> Interactive = with user comments.
>>
>> The static docs update every day from cvs for 8.4. So people with doc  
>> patches can certainly see their changes included.
> 
> OK, I understand the distinction in terms now but there used to be a doc
> build that built every 5 minutes or so, if needed.  It is here:
> 
>     http://developer.postgresql.org/pgdocs/postgres/index.html
> 
> and it used to be listed here:
> 
>     http://www.postgresql.org/developer/testing
> 
> plus there was a link that showed what changes had been made to CVS
> during the last doc build.  I think those links should be restored to
> that page.

well not sure I see the point here, for the kind of people we want 
getting BETA feedback on a latency of 24h for doc-changes seems well 
within reasonable limits. And for developers who are interested in the 
actual build process we could easily add the developer.postgresql.org 
URL to say the developer FAQ on the wiki.
The main point for adding the docs on the main site is to make them look 
like the docs for released versions and to benefit from the fast mirror 
network.


Stefan


В списке pgsql-www по дате отправления:

Предыдущее
От: Bruce Momjian
Дата:
Сообщение: Re: static developer docs
Следующее
От: Josh Berkus
Дата:
Сообщение: Please update Regional Contacts