[ 
https://issues.apache.org/jira/browse/AURORA-985?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14309361#comment-14309361
 ] 

Jake Farrell commented on AURORA-985:
-------------------------------------

would we want this to be included in each source releases? I would say no. what 
about making this a submodule? could have all the same benefits described and 
would make it easier for releases to exclude it

> Move Aurora website source to subdirectory of git repo
> ------------------------------------------------------
>
>                 Key: AURORA-985
>                 URL: https://issues.apache.org/jira/browse/AURORA-985
>             Project: Aurora
>          Issue Type: Task
>            Reporter: Dave Lester
>
> Currently the source of the Aurora website lives in subversion; static files 
> generated by Middleman live in a /site/publish/ folder that renders online at 
> aurora.incubator.apache.org. However, since documentation is rendered on the 
> website (and included in the /docs folder of the codebase) it requires they 
> be copied from git to svn whenever a change is made.
> This ticket proposes to move the contents of the /site/source/ folder 
> (currently on subversion) to git, and to be part of the same repository where 
> the aurora codebase lives.
> This change would make it possible to:
> 1) avoid a `git clone` of docs from the git repo to subversion
> 2) easily vet documentation changes to the main Aurora codebase by seeing how 
> they will render on the website. Having them in two separate repos currently 
> makes this cumbersome, and encourages folks to ship documentation without 
> verifying what it looks like.
> 3) simplifies the process of committing documentation changes to the website 
> by making it possible w/in the same repo as the full codebase



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to