Commiting doc folder to svn

Rails
1

Hi
I would like to know expert opinion on this. Should I commit folders
like doc/app into svn? What is the general strategy

Thanks
Tom

2

Tom M. wrote:

Hi
I would like to know expert opinion on this. Should I commit folders
like doc/app into svn? What is the general strategy

Nothing should ever be committed to svn… http://git-scm.com/ :slight_smile:

However, yes I most definitely version control my application
documentation.

3

Robert W. wrote:

Tom M. wrote:

Hi
I would like to know expert opinion on this. Should I commit folders
like doc/app into svn? What is the general strategy

Nothing should ever be committed to svn… http://git-scm.com/ :slight_smile:

Agreed!

However, yes I most definitely version control my application
documentation.

Are you referring to files generated by rdoc, or other files? The
latter definitely go into version control, but I’m not sure if the
former should…

Best,
–Â
Marnen Laibow-Koser
http://www.marnen.org
[email protected]

4

Marnen Laibow-Koser wrote:

Robert W. wrote:

However, yes I most definitely version control my application
documentation.

Are you referring to files generated by rdoc, or other files? The
latter definitely go into version control, but I’m not sure if the
former should…

Oh, I wasn’t thinking about RDoc docs. So yea, I was referring to other
docs/READMEs.

I would consider RDoc documentation to be a build product. The RDoc
source is already under version control with the code. It would be
redundant to version control the generated output.

5

Hi
I was asking about should I commit to svn the folder generated by

rake doc:app

        ie  doc/app folder completely
6

Robert W. wrote:

Marnen Laibow-Koser wrote:

Robert W. wrote:

However, yes I most definitely version control my application
documentation.

Are you referring to files generated by rdoc, or other files? The
latter definitely go into version control, but I’m not sure if the
former should…

Oh, I wasn’t thinking about RDoc docs. So yea, I was referring to other
docs/READMEs.

Right.

I would consider RDoc documentation to be a build product. The RDoc
source is already under version control with the code. It would be
redundant to version control the generated output.

That’s my opinion too.

Best,

Marnen Laibow-Koser
http://www.marnen.org
[email protected]