commiting doc folder to svn

rubyonrails-talk
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 Mac 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 Walker wrote:

Tom Mac 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,

4

Marnen Laibow-Koser wrote:

Robert Walker 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

Robert Walker wrote:

Marnen Laibow-Koser wrote:

Robert Walker 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,

6

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

  rake doc:app

            ie doc/app folder completely