Ok, thanks Thomas, I can fix these minor errors in both en and zh documents upon my user rights. >From you reply, there is no standards for the doc internal links, I'd like to >continue my way to fix them.
Cheers! Jason. Thomas Weidner <[EMAIL PROTECTED]> wrote: As these ID's you are referring are just for internal linking and not displayed external generally it should be no problem. Also it's sometimes hard to name such internal links when the name is good for 2 examples showing the same in 2 ways... but feel free to rename them, as long as you also rename all other languages. Docu maintainers tend to forget renaming the links because they are not translated :-) Or create an jira issue with the links and the new naming... it will be fixed by me from time to time for all languages. But I don't think that we need a documentation standard just for internal links or headers. Greetings Thomas Weidner, I18N Team Leader http://www.thomasweidner.com ----- Original Message ----- From: "Jason Qi" To: "Zend Mailing List" Sent: Wednesday, February 06, 2008 6:15 AM Subject: Re: [fw-general] Re: Documentation on framework site > BTW, do we have the document standard, such as name convention, intent > other than DTD docbook ? > > i.g. > > sometime when I do "make check", there are some minor error message that > indicated duplicated ID names. I saw someone correct it by put a > number(and/or alphabet) suffix, like "samename-1" or "samename-1a" etc. I > used my way to correct it by according their contexts. > > I believe it is better we have such a document standard to accommodate the > increasing documents. > > Maybe there is a standard(like code standard) that I did not know ? > > Just my 2c. > > Jason. > > > Eric Coleman wrote: Why not use a version number in > the url? > > Or, what about putting some kind of "version" number information into > the docbook data? that way a component can specify what version it > was introduced, etc... would be nice :-d > > Regards, > Eric > > On Feb 5, 2008, at 10:03 PM, Simon Mundy wrote: > >> Heh, yeah I _would_ ... but I know nothing about how the manual gets >> from the repository to the website :) >> >> I'll wait to see if any of the existing maintainers put their hand >> up and if not then we'll put a prop up on the wiki post-1.5 >> >> Cheerio >> >>> To be honest, IMO the documentation situation is far from ideal right >>> now, and I can definitely see your point. On the other hand, 1.5. ;) >>> Have you considered putting together a proposal and reviewing what >>> changes would be required to our release process and build scripts? >>> As >>> I'm sure you've noticed, Simon, the best way to get something done in >>> framework is to do as much as you can yourself without blocking on >>> any >>> Zend involvement. :D Let me know what I can do to help you here, and >>> keep in mind that you might get more traction after 1.5 drops. >>> >>> Thanks. >>> ,Wil >>> >>>> -----Original Message----- >>>> From: Simon Mundy [mailto:[EMAIL PROTECTED] >>>> Sent: Tuesday, February 05, 2008 6:39 PM >>>> To: Wil Sinclair >>>> Cc: Zend Mailing List >>>> Subject: Documentation on framework site >>>> >>>> Hi Wil >>>> >>>> I'm not sure if this has been requested before, but would it be >>>> possible to make it slightly clearer on the documentation pages that >>>> the manual refers to the current trunk release of the framework? >>>> >>>> If not that then perhaps hold back updates on the website until a >>>> minor/major version has been released. I've seen a few cases where >>>> people are confused as the new documentation refers to functionality >>>> or changes that haven't yet been released to a stable version. >>>> >>>> Or perhaps a-la MySQL's site there could be a browseable-by-version >>>> page on the site? I'm not sure how automated the current process >>>> is so >>>> hope I'm not asking for a biggy here :) >>>> >>>> -- >>>> >>>> Simon Mundy | Director | PEPTOLAB >>>> >>>> """ " "" """""" "" "" """"""" " "" """"" " """"" " """""" "" " >>>> >>>> 202/258 Flinders Lane | Melbourne | Victoria | Australia | 3000 >>>> Voice +61 (0) 3 9654 4324 | Mobile 0438 046 061 | Fax +61 (0) 3 9654 >>>> 4124 >>>> http://www.peptolab.com >>> >> >> -- >> >> Simon Mundy | Director | PEPTOLAB >> >> """ " "" """""" "" "" """"""" " "" """"" " """"" " """""" "" " >> >> 202/258 Flinders Lane | Melbourne | Victoria | Australia | 3000 >> Voice +61 (0) 3 9654 4324 | Mobile 0438 046 061 | Fax +61 (0) 3 9654 >> 4124 >> http://www.peptolab.com >> > > > > > --------------------------------- > Never miss a thing. Make Yahoo your homepage. --------------------------------- Never miss a thing. Make Yahoo your homepage.
