« Return to Thread: Documentation is generated from the trunk not from the latest stable release

Re: Documentation is generated from the trunk not from the latest stable release

by weierophinney :: Rate this Message:

Reply to Author | View in Thread

-- Thomas Weidner <thomas.weidner@...> wrote
(on Friday, 10 October 2008, 10:39 AM +0200):
> Your suggestion would mean that we can not add new features in trunk as  
> every commit must include code, unittests AND documentation.
>
> Leaving out documentation would then mean no new features in trunk.
> Is this really what you suggest ?

Thomas -- there is a solution to this: build documentation off the
release branch. However, we need to come up with a strategy for (a)
having versioned documentation on the website, and (b) how and when to
merge documentation changes to the release branch (something that has
never been required before for documentation translators). The internal
team has this on our backlog.


> ----- Original Message ----- From: "Jean-Marc Fontaine" <jmf@...>
> To: "Thomas Weidner" <thomas.weidner@...>
> Cc: <fw-docs@...>
> Sent: Friday, October 10, 2008 10:02 AM
> Subject: Re: Documentation is generated from the trunk not from the
> latest stable release
>
>
>> Hello Thomas,
>>
>>> But the manual in trunk states that this features are available with  
>>> 1.7... so this should not be a big problem at all.
>> The documentation only mentions 1.7 release once : "Zend_Translate  
>> recognises also an application wide locale". There is nothing regarding
>> the "ignore" option.
>>
>> BTW, this is another problem. I read the whole Zend_Translate  
>> documentation last week. I saw "Since Zend Framework 1.7.0". I guessed  
>> "It's out !" but no, it isn't.
>>
>> Having a trunk documentation somewhere is fine but the main
>> documentation should be from the latest stable release IMHO.
>>
>> Regards,
>>
>> Jean-Marc
>>
>> --------------------------------------------
>> Kanopée - Développement Informatique Durable
>> 57 rue d'Haubourdin
>> 59139 Wattignies
>>
>> Tél      : 03 20 74 61 25
>> Portable : 06 88 56 50 79
>> Fax      : 09 59 77 04 28
>> Web      : http://www.kanopee.net/ 
>

--
Matthew Weier O'Phinney
Software Architect       | matthew@...
Zend Framework           | http://framework.zend.com/

 « Return to Thread: Documentation is generated from the trunk not from the latest stable release