On Feb 26, 2013, at 1:01 PM, Radhika Puthiyetath <radhika.puthiyet...@citrix.com> wrote:
> Hi Sebastien, > > I meant first set of feature documentation ready by 2/28, then next set of > feature documentation (late entries) delivery on another milestone. > > If we have more than one milestone, or translation delivery (to Transifex) > dates we might be able to accommodate all the features. > > Because I don't think AWS Style Regions will be done by the 2/28 milestone. > > Do correct me. > > Thanks again. > We agreed that the 2/28 deadline for doc freeze will slip a bit, leaving a smaller time frame for translation of the 4.1 release documentation. Realistically the translations will be incomplete (except some of the UI and the runbook), our first concern should be to get as much of the needed documentation in. So don't worry about missing the 2/28 date. -Sebastien > -Radhika > > -----Original Message----- > From: Sebastien Goasguen [mailto:run...@gmail.com] > Sent: Tuesday, February 26, 2013 7:17 PM > To: cloudstack-dev@incubator.apache.org > Subject: Re: [DOCS][DISCUSS]Documentation for 4.1 > > > On Feb 26, 2013, at 5:25 AM, Radhika Puthiyetath > <radhika.puthiyet...@citrix.com> wrote: > >> Hello Documentation contributors/ Localization maintainers, >> >> Would it be possible for us to plan multiple localization drop for >> documentation ? In that way, we can accommodate most of the late additions, >> for example, UI changes for AWS-Style Regions or any defect fixes on >> features. > > Radhika, I don't understand what you mean by localization drop ? can you > explain ? > >> >> Sorry about my ignorance if that is the way localization is dealt with >> currently by the translation team. >> >> Please do educate me also on the process followed for localizing the UI >> strings. > > If by localization you mean translation, the UI strings are translated the > same way than the rest of the documentation. The source file has been > uploaded to transifex and people are translating there. We also received a > patch for korean translation via review board. > > >> >> Thanks >> >> -Radhika >> >> -----Original Message----- >> From: Sebastien Goasguen [mailto:run...@gmail.com] >> Sent: Tuesday, February 12, 2013 10:43 PM >> To: cloudstack-dev@incubator.apache.org >> Subject: Re: [DOCS][DISCUSS]Documentation for 4.1 >> >> >> On Feb 12, 2013, at 5:54 PM, Joe Brockmeier <j...@zonker.net> wrote: >> >>> On Tue, Feb 12, 2013 at 05:25:11PM +0100, Sebastien Goasguen wrote: >>>> After 2/28 we will just fix doc bugs, not add new docs, even if a >>>> feature is included in 4.1 if its docs are not in by 2/28 then too bad. >>> >>> -1 to this. >>> >>> The reason for stopping feature development with a hard freeze is >>> that new features have the potential to disrupt the codebase badly >>> enough that it's a major issue. >>> >>> Adding new docs makes it a problem for translators, but it doesn't >>> carry the same level of disruption as new features. For example, >>> think about the impact if Javelin landed a week later than it did into >>> master vs. >>> the impact of adding another section to the install or admin guide. >>> It's not really comparable. >>> >>> Also - leaving a feature out of a release means it can be picked up >>> in a later release. Failing to document features is, basically, a bug >>> that should be fixed (if possible) before a release. >> >> But if it cannot be fixed on-time it should not be a release blocker or a >> reason to slip the release date. >> >>> >>>> That's a bit of tough love, but that's what will happen if we want >>>> to stick to the schedule. >>> >>> I'd like to stick to the schedule, but we should have more >>> flexibility here than with features. It's also worth noting this is >>> the first time through with a hard feature release and we're still >>> finding our way >>> - and what we seem to be finding is that ~1 month for documentation >>> is a bit tricky when a lot of features land (or don't) right on the >>> feature deadline. >>> >> >> That's fine with me, it just means that we need to update the schedule. >> And we need to make sure that what's in the 4.1 documentation plan pointed >> out by Radhika actually only targets features that made the 4.1 cut. >> >> -sebastien >> >> >>> Best, >>> >>> jzb >>> -- >>> Joe Brockmeier >>> http://dissociatedpress.net/ >>> Twitter: @jzb >> >
