Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 93393 - cvs tutorial update
Summary: cvs tutorial update
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: CVS tutorial (show other bugs)
Hardware: All Other
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-05-20 18:45 UTC by Jonathan Smith (RETIRED)
Modified: 2005-05-25 02:24 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jonathan Smith (RETIRED) gentoo-dev 2005-05-20 18:45:19 UTC
the cvs tutorial (as someone who is needing it wrt bug 93356) is rather wordy and, quite frankly, a pain to work with.

as an example, it tells people to download the source and compile by hand _before_ telling them about "emerge cvs"! scanning the doc shows a number of rather obnoxious errors like this...

is everyone ok with my making a major style update while keeping much of the content the same? i might even update it with a bit about repoman and a link to the dev-handbook...

i'm gonna wait to get feedback before i actually do it
Comment 1 Jonathan Smith (RETIRED) gentoo-dev 2005-05-20 18:48:56 UTC
one quick clarification: i plan to totally rewrite the doc, but keep the same
basic information (cleaning it up would basically be a rewrite anyway; its
easier to start from scratch imho)
Comment 2 SpanKY gentoo-dev 2005-05-20 18:51:03 UTC
the cvs doc was written before Gentoo afaik which is why all the extra stuff is
there
Comment 3 SpanKY gentoo-dev 2005-05-20 18:51:22 UTC
stupid bugzilla ...
Comment 4 Jonathan Smith (RETIRED) gentoo-dev 2005-05-20 18:52:19 UTC
is that a vote for redoing it?
Comment 5 Xavier Neys (RETIRED) gentoo-dev 2005-05-23 05:10:56 UTC
I cleaned up the installation procedure to leave a simple emerge cvs.
Maybe we could add a word about `cvs diff`.
Apart from that, I fail to see any other problems. 

Instead of a doing a full write for the fun of it, say what's wrong with it and
let's fix it.
Repoman and devrel-handbook have got nothing to do with this guide.
I guess you were looking for
http://www.gentoo.org/proj/en/devrel/new-dev-training.xml or its devrel HB
equivalent: http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=1&chap=4
Comment 6 Jonathan Smith (RETIRED) gentoo-dev 2005-05-23 05:31:20 UTC
well, i was also thinking we could link repoman and devrel to this doc. not
duplicate, link...
Comment 7 Xavier Neys (RETIRED) gentoo-dev 2005-05-23 05:38:44 UTC
Aforementioned docs both link to /doc/en/cvs-tutorial.xml at the very beginning.
Comment 8 Jonathan Smith (RETIRED) gentoo-dev 2005-05-23 12:59:27 UTC
sorry, i somehow missed that...

resolved?
Comment 9 Xavier Neys (RETIRED) gentoo-dev 2005-05-25 02:24:11 UTC
ok