2007.1 Handbook mojo

HEY GUYS, IT'S THAT TIME OF YEAR AGAIN, AND I'LL AGAIN BE
HANDBOOK
RELEASE COORDINATOR. I OPENED A TRACKER BUG[1] FOR YOUR
VIEWING PLEASURE.

I'VE STARTED DOING THE INITIAL DOCUMENTATION IMPORTS, AND
WILL BE DOING
THE REST AND PREPPING THE DOCS WITH THE SMALL CHANGES LATER,
ONCE I'M
BACK FROM WORK.

SO WHAT I NEED FROM YOU GUYS IS YOUR AVAILABILITY STATUS FOR
WORKING ON
DOCS -- FOR THE LAST FEW RELEASES I'VE PRETTY MUCH MADE ALL
THE CHANGES
SINGLEHANDEDLY, AND THAT'S QUITE A LOAD TO BEAR. SO, WHO'S
AROUND?

TRANSLATORS, YOU'RE GOING TO HAVE EXTRA FUN, AS THERE WILL
BE LOTS OF
CHANGES MADE IN A VERY SHORT TIME FOR YOU TO FOLLOW.
ACTUALLY, WHAT
ACTIVE LANGUAGES DO WE HAVE? I DON'T EVEN KNOW THAT ANYMORE.
WHO WILL
HAVE COMPLETE TRANSLATIONS READY AT SOME POINT FOR 2007.1?
THIS AFFECTS
WHAT I PUT INTO OUR INDEX.XML FILES.

WE GOT A LOT OF DOCS TO COVER, NOT JUST THE INSTALLATION
HANDBOOKS. SEE
[2], CHAPTER 2, FOR A LISTING.

ANYWAY, I'LL KEEP YOU UPDATED AS WE REACH MILESTONES. I SAY
"WE" BECAUSE
I HOPE AT LEAST SOME OF YOU WILL BE AVAILABLE TO HELP OUT.


LUCK, AND A GREAT RELEASE,

JOSH


[1] HTTP://BUGS.GENTOO.ORG/SHOW_BUG.CGI?ID=197814
[2]
HTTP://WWW.GENTOO.ORG/PROJ/EN/GDP/DOC/HANDBOOK-RELEASE.XML

ON THURSDAY 01 NOVEMBER 2007 16:57:53 JOSH SADDLER WROTE:
> HEY GUYS, IT'S THAT TIME OF YEAR AGAIN, AND I'LL AGAIN
BE HANDBOOK
> RELEASE COORDINATOR. I OPENED A TRACKER BUG[1] FOR YOUR
VIEWING PLEASURE.
>
> I'VE STARTED DOING THE INITIAL DOCUMENTATION IMPORTS,
AND WILL BE DOING
> THE REST AND PREPPING THE DOCS WITH THE SMALL CHANGES
LATER, ONCE I'M
> BACK FROM WORK.
>
> SO WHAT I NEED FROM YOU GUYS IS YOUR AVAILABILITY
STATUS FOR WORKING ON
> DOCS -- FOR THE LAST FEW RELEASES I'VE PRETTY MUCH MADE
ALL THE CHANGES
> SINGLEHANDEDLY, AND THAT'S QUITE A LOAD TO BEAR. SO,
WHO'S AROUND?
>
> TRANSLATORS, YOU'RE GOING TO HAVE EXTRA FUN, AS THERE
WILL BE LOTS OF
> CHANGES MADE IN A VERY SHORT TIME FOR YOU TO FOLLOW.
ACTUALLY, WHAT
> ACTIVE LANGUAGES DO WE HAVE? I DON'T EVEN KNOW THAT
ANYMORE. WHO WILL
> HAVE COMPLETE TRANSLATIONS READY AT SOME POINT FOR
2007.1? THIS AFFECTS
> WHAT I PUT INTO OUR INDEX.XML FILES.

/DE SHOULD HAVE X86 & AMD64 DONE LESS THAN A WEEK AFTER
THINGS SETTLE DOWN, 
WITH OTHER ARCHES IN THE FOLLOWING WEEK. THIS ESTIMATE OF
COURSE IS DEPENDENT 
ON THE SIZE OF THE CHANGES. I PLAN ON DOING 2007.1
PERSONALLY AND WILL FINISH 
IT AS QUICKLY AS POSSIBLE. IT'S NICE THAT THINGS ARE
STARTING NOW SINCE I 
JUST FINISHED MIDTERMS.

IT WOULD BE GREAT IF COMMIT MESSAGES OR MAILING LIST POSTS
COULD INCLUDE 
NOTICES WHEN CERTAIN FILES SETTLE DOWN. OF COURSE THAT IS
ONLY POSSIBLE OF 
DEVELOPERS ARE NICE AND GET THE CHANGES INTO THE BUG REPORT
IN DUE TIME SO I 
REALIZE THAT IT MIGHT NOT BE EASY. 

HENDRIK

Josh Saddler wrote:
> Hey guys, it's that time of year again, and I'll again
be Handbook
> Release Coordinator. I opened a tracker bug[1] for your
viewing pleasure.
> 
> I've started doing the initial documentation imports,
and will be doing
> the rest and prepping the docs with the small changes
later, once I'm
> back from work.
> 
> So what I need from you guys is your availability
status for working on
> docs -- for the last few releases I've pretty much made
all the changes
> singlehandedly, and that's quite a load to bear. So,
who's around?
> 
> Translators, you're going to have extra fun, as there
will be lots of
> changes made in a very short time for you to follow.
Actually, what
> active languages do we have? I don't even know that
anymore. Who will
> have complete translations ready at some point for
2007.1? This affects
> what I put into our index.xml files.
> 
> We got a lot of docs to cover, not just the
installation handbooks. See
> [2], Chapter 2, for a listing.
> 
> Anyway, I'll keep you updated as we reach milestones. I
say "we" because
> I hope at least some of you will be available to help
out. 
> 
> Luck, and a great release,
> 
> Josh
> 
> 
> [1] http://
bugs.gentoo.org/show_bug.cgi?id=197814
> [2] http://www.gentoo.org/proj/en/gdp/doc/handbook-release
.xml
> 

I'll be handling the ppc and ppc64 handbooks this release. 
I'd like
to combine them actually, since we'll be using the same
release
media for both architectures.  Would this be fine with you
guys?
Did anything ever happen with the templated handbook idea?

-Joe
-- 
gentoo-docgentoo.org mailing list

JOSEPH JEZAK WROTE:
> JOSH SADDLER WROTE:
>> HEY GUYS, IT'S THAT TIME OF YEAR AGAIN, AND I'LL
AGAIN BE HANDBOOK
>> RELEASE COORDINATOR. I OPENED A TRACKER BUG[1] FOR
YOUR VIEWING PLEASURE.
>>
>> I'VE STARTED DOING THE INITIAL DOCUMENTATION
IMPORTS, AND WILL BE DOING
>> THE REST AND PREPPING THE DOCS WITH THE SMALL
CHANGES LATER, ONCE I'M
>> BACK FROM WORK.
>>
>> SO WHAT I NEED FROM YOU GUYS IS YOUR AVAILABILITY
STATUS FOR WORKING ON
>> DOCS -- FOR THE LAST FEW RELEASES I'VE PRETTY MUCH
MADE ALL THE CHANGES
>> SINGLEHANDEDLY, AND THAT'S QUITE A LOAD TO BEAR.
SO, WHO'S AROUND?
>>
>> TRANSLATORS, YOU'RE GOING TO HAVE EXTRA FUN, AS
THERE WILL BE LOTS OF
>> CHANGES MADE IN A VERY SHORT TIME FOR YOU TO
FOLLOW. ACTUALLY, WHAT
>> ACTIVE LANGUAGES DO WE HAVE? I DON'T EVEN KNOW THAT
ANYMORE. WHO WILL
>> HAVE COMPLETE TRANSLATIONS READY AT SOME POINT FOR
2007.1? THIS AFFECTS
>> WHAT I PUT INTO OUR INDEX.XML FILES.
>>
>> WE GOT A LOT OF DOCS TO COVER, NOT JUST THE
INSTALLATION HANDBOOKS. SEE
>> [2], CHAPTER 2, FOR A LISTING.
>>
>> ANYWAY, I'LL KEEP YOU UPDATED AS WE REACH
MILESTONES. I SAY "WE" BECAUSE
>> I HOPE AT LEAST SOME OF YOU WILL BE AVAILABLE TO
HELP OUT. 
>>
>> LUCK, AND A GREAT RELEASE,
>>
>> JOSH
>>
>>
>> [1] HTTP://BUGS.GENTOO.ORG/SHOW_BUG.CGI?ID=197814
>> [2]
HTTP://WWW.GENTOO.ORG/PROJ/EN/GDP/DOC/HANDBOOK-RELEASE.XML
>>
> 
> I'LL BE HANDLING THE PPC AND PPC64 HANDBOOKS THIS
RELEASE.  I'D LIKE
> TO COMBINE THEM ACTUALLY, SINCE WE'LL BE USING THE SAME
RELEASE
> MEDIA FOR BOTH ARCHITECTURES.  WOULD THIS BE FINE WITH
YOU GUYS?
> DID ANYTHING EVER HAPPEN WITH THE TEMPLATED HANDBOOK
IDEA?
> 
> -JOE

I NEVER HEARD BACK FROM XAVIER ON THE HANDBOOK INCLUDES
PROPOSAL, SO . .
. WHO KNOWS. COMBINING THE PPC HANDBOOKS SEEMS LIKE IT'LL
TAKE QUITE A
BIT OF WORK THOUGH, AS I IMAGINE THERE WILL NEED TO BE A LOT
OF
CONDITIONALS FOR 64/32-BIT DIFFERENCES. WELL, THAT'S WHAT
I'M GUESSING
ANYWAY. I MEAN, THERE'S A WHILE EXTRA CHAPTER OR SOMETHING
JUST FOR
OLDWORLD MACHINES, AND OTHER 32-BIT PPC PLATFORMS.

STILL, LET'S TAKE A LOOK AT THE CODE AND SEE WHAT DUPLICATES
WHAT. I'M
SURE WE CAN THINK OF SOMETHING. 

(THOUGH IT REALLY REALLY WOULD BE NICE TO FINALLY GET
HANDBOOK INCLUDES
FOR EVERYTHING! --HINT HINT)

JOSEPH JEZAK WROTE:
> I'LL BE HANDLING THE PPC AND PPC64 HANDBOOKS THIS
RELEASE.  I'D LIKE
> TO COMBINE THEM ACTUALLY, SINCE WE'LL BE USING THE SAME
RELEASE
> MEDIA FOR BOTH ARCHITECTURES. WOULD THIS BE FINE WITH
YOU GUYS?

SURE. USING THE CONDITIONALS LIKE WE DID FOR X86/AMD64
SHOULD HELP. IA64
SHARES ONE OF THE JOINED FILES IIRC.
YOU DON'T HAVE TO JOIN ALL 4 DISTINCT FILES BTW. COMBINE THE
FILES THAT SHARE
A LOT OF CONTENT, BUT KEEP THE VERY DIFFERENT ONES
SEPARATE.

JUST ASK IF YOU NEED HELP TO USE THOSE CONDITIONALS.

> DID ANYTHING EVER HAPPEN WITH THE TEMPLATED HANDBOOK
IDEA?

TEMPLATED HANBOOK IDEA? DID YOU MEAN THE INCLUDE IDEA LIKE
JOSH GUESSED?
IF SO, IT'S *ALMOST* WORKING ON MY HOME BOX (NOT THE PUBLIC
ONE), BUT I STILL
NEED TO FIX SOME ANCHORS AND THE COMPARISON OF TRANSLATIONS
VS. ORIGINALS
WHEN & WHETHER IT WILL MAKE IT TO OUR GUIDE.XSL IS STILL
NOT CLEAR, BUT IT
WOULD TAKE PLENTY OF TIME, MOTIVATION AND TESTING BEFORE IT
ENDS UP ON
WWW.G.O. I HOPE WE'D BE ABLE TO USE A TEST WEB NODE, MAYBE
BLUEJAY OF PHEASANT.


CHEERS,
-- 
/  XAVIER NEYS
_ GENTOO DOCUMENTATION PROJECT
/
/ HTTP://WWW.GENTOO.ORG/DOC/EN/

XAVIER NEYS WROTE:
> TEMPLATED HANBOOK IDEA? DID YOU MEAN THE INCLUDE IDEA
LIKE JOSH GUESSED?
> IF SO, IT'S *ALMOST* WORKING ON MY HOME BOX (NOT THE
PUBLIC ONE), BUT I STILL
> NEED TO FIX SOME ANCHORS AND THE COMPARISON OF
TRANSLATIONS VS. ORIGINALS
> WHEN & WHETHER IT WILL MAKE IT TO OUR GUIDE.XSL IS
STILL NOT CLEAR, BUT IT
> WOULD TAKE PLENTY OF TIME, MOTIVATION AND TESTING
BEFORE IT ENDS UP ON
> WWW.G.O. I HOPE WE'D BE ABLE TO USE A TEST WEB NODE,
MAYBE BLUEJAY OF PHEASANT.


I LOVE IT WHEN YOU TALK DIRTY. 

SERIOUSLY THOUGH, I'M THRILLED THAT YOU'VE GOT IT TO WHERE
IT IS NOW;
I'D LOVE TO SEE IT IN PLACE ON OUR WEBSITE. WHO DO WE BUG
FOR ACCESS TO
BLUEJAY? INFRA? OR WWW ?

Josh Saddler wrote:
> Translators, you're going to have extra fun, as there
will be lots of
> changes made in a very short time for you to follow.
Actually, what
> active languages do we have? I don't even know that
anymore. Who will
> have complete translations ready at some point for
2007.1? This affects
> what I put into our index.xml files.

Simplified Chinese team is standing by.

-- 
Zhang Le, Robert
GPG key ID: 1E4E2973
Fingerprint: 0260 C902 B8F8 6506 6586 2B90 BC51 C808 1E4E
2973
-- 
gentoo-docgentoo.org mailing list

Il Monday 05 November 2007 20:45:20 Zhang Le ha scritto:
> Josh Saddler wrote:
> > Translators, you're going to have extra fun, as
there will be lots of
> > changes made in a very short time for you to
follow. Actually, what
> > active languages do we have? I don't even know
that anymore. Who will
> > have complete translations ready at some point for
2007.1? This affects
> > what I put into our index.xml files.
>
> Simplified Chinese team is standing by.
>

And Italian team is ready too 8)

Cheers,

-- 
Davide Cendron

Gentoo Documentation Project
Italian Lead Translator

http://www.gentoo.org/d
oc/it/

Davide Cendron írta:
> Il Monday 05 November 2007 20:45:20 Zhang Le ha
scritto:
>   
>> Josh Saddler wrote:
>>     
>>> Translators, you're going to have extra fun, as
there will be lots of
>>> changes made in a very short time for you to
follow. Actually, what
>>> active languages do we have? I don't even know
that anymore. Who will
>>> have complete translations ready at some point
for 2007.1? This affects
>>> what I put into our index.xml files.
>>>       
>> Simplified Chinese team is standing by.
>>
>>     
>
> And Italian team is ready too 8)
>
> Cheers,
>
>   
The Hungarian team is also ready to work 

-- 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Németh Balázs

web:   http://kac.duf.hu/~balage

Public GPG key: http://kac.duf.hu/~balage/downloads/N
emeth_Balazs_public_key_0xB0B0F0D9.asc

JOSH SADDLER WROTE:
> XAVIER NEYS WROTE:
>> TEMPLATED HANBOOK IDEA? DID YOU MEAN THE INCLUDE
IDEA LIKE JOSH GUESSED?
>> IF SO, IT'S *ALMOST* WORKING ON MY HOME BOX (NOT
THE PUBLIC ONE), BUT I STILL
>> NEED TO FIX SOME ANCHORS AND THE COMPARISON OF
TRANSLATIONS VS. ORIGINALS
>> WHEN & WHETHER IT WILL MAKE IT TO OUR GUIDE.XSL
IS STILL NOT CLEAR, BUT IT
>> WOULD TAKE PLENTY OF TIME, MOTIVATION AND TESTING
BEFORE IT ENDS UP ON
>> WWW.G.O. I HOPE WE'D BE ABLE TO USE A TEST WEB
NODE, MAYBE BLUEJAY OF PHEASANT.
> 
> SERIOUSLY THOUGH, I'M THRILLED THAT YOU'VE GOT IT TO
WHERE IT IS NOW;
> I'D LOVE TO SEE IT IN PLACE ON OUR WEBSITE. WHO DO WE
BUG FOR ACCESS TO
> BLUEJAY? INFRA? OR WWW ?

I HAVE ROOT ON BLUEJAY (IT RUNS OFF A SNAPSHOT OF HTDOCS
ATM.) BUT SINCE
THERE'S NOTHING AVAILABLE TO BE PUT ON IT FOR TESTING...

GOOD NEWS:
I BELIEVE I'VE GOT IT RIGHT ON MY BOX.
I TESTED TWO GUIDES[1][2] (I ALREADY HAD THIS FEATURE IN
MIND WHEN I REWROTE
THE QUICK GUIDE AND ITS LVM+RAID SIBLING), AND A BIT OF A
HANDBOOK[3].

BAD NEWS:
I STILL DON'T KNOW WHEN, OR EVEN WHETHER, THIS WOULD BE
AVAILABLE IN GENTOO'S
OWN XSL. ALMOST ALL TEMPLATES NEED TO BE CHANGED AND IT'S
*NOT* GOING TO
HAPPEN OVERNIGHT.

[1]
HTTP://GENTOO.NEYSX.ORG/MYSTUFF/GENTOO-X86+RAID+LVM2-QUICKIN
STALL.XML
[2]
HTTP://GENTOO.NEYSX.ORG/MYSTUFF/GENTOO-X86-QUICKINSTALL.XML
[3]
HTTP://GENTOO.NEYSX.ORG/MYSTUFF/HANDBOOK/HANDBOOK-X86.XML?PA
RT=1&CHAP=4

THE LOGIC IS CHAPTERS, SECTIONS AND BODIES CAN ALL BE
INCLUDED, I.E. THEY
EITHER HAVE THE CURRENT STRUCTURE OR CONTAIN A SINGLE
<INCLUDE HREF=""/>
ELEMENT. A CHAPTER CAN INCLUDE CHAPTERS, A SECTION CAN
INCLUDE SECTIONS AND A
BODY CAN INCLUDE BODIES.

IT'S A BIT UNFAIR TO LET YOU KNOW ALL THIS WITHOUT KNOWING
WHEN OR WHETHER YOU
CAN USE IT, BUT AT LEAST YOU KNOW...


CHEERS,
-- 
/  XAVIER NEYS
_ GENTOO DOCUMENTATION PROJECT
/
/ HTTP://WWW.GENTOO.ORG/DOC/EN/