You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@storm.apache.org by "ASF GitHub Bot (JIRA)" <ji...@apache.org> on 2016/03/10 22:50:41 UTC
[jira] [Commented] (STORM-1617) storm.apache.org has no release
specific documentation
[ https://issues.apache.org/jira/browse/STORM-1617?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15190010#comment-15190010 ]
ASF GitHub Bot commented on STORM-1617:
---------------------------------------
GitHub user revans2 opened a pull request:
https://github.com/apache/storm/pull/1203
!!! DO NOT MERGE !!! STORM-1617 preview !!! DO NOT MERGE !!!
This is intended to be a preview of STORM-1617. It is by no means done, but I wanted to get some feedback on this.
Adding in all of the javadocs added in about 88MB. So I am thinking that asf-site itself might need to be in the subversion repo, just so we don't impact all developers with all of the extra files, but I am open to most suggestions.
At this point I have only brought over the javadocs and only put in the 0.10.0 and 0.9.6 releases.
I added in a data file `releases.yaml` that is used to create links to all of the different release sub-directories. If others think this looks OK at a high level, I will start to go through and add in the rest of the release specific docs. Put in the rest of the missing releases. and see if I can put in a permalink, or a sym-link for our current stable release.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/revans2/incubator-storm versioned-site
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/storm/pull/1203.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #1203
----
commit b12f899b7a1177576035bb0e628622ebda1362d9
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T18:54:58Z
Soem cleanup
commit 0140297c0f7f8cc081008bdecce5c7dc8f00a8fa
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T18:57:14Z
Config issue
commit 47fe62e75c91649d85afd6dcaf6a6170562e6627
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T20:30:22Z
Checkpoint
commit d3d7e87bac0b4fbf417a12ae0cc16742a5f6588a
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T20:53:06Z
A few more things updated to make this work
commit c5d8dc938e835c1ec93680886060c4f53574cb9c
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T20:56:58Z
Added in 0.9.6 javadocs
commit 5a8e4e78f325eea6a60cda962e97b0287bfc9b8f
Author: Robert (Bobby) Evans <ev...@yahoo-inc.com>
Date: 2016-03-10T21:08:25Z
Updated header to point to proper pages
----
> storm.apache.org has no release specific documentation
> ------------------------------------------------------
>
> Key: STORM-1617
> URL: https://issues.apache.org/jira/browse/STORM-1617
> Project: Apache Storm
> Issue Type: Bug
> Components: asf-site
> Reporter: Robert Joseph Evans
> Assignee: Robert Joseph Evans
>
> Our current documentation on http://storm.apache.org/ has no place to put release specific documentation. Ever other project I know of has a little bit of generic information, but most of the site is tied to a specific release. I would like to copy that model and I propose that the following files be maintained only on the asf-site branch. All other files will be moved to a documentation directory on the individual branches, and a copy of each, along with the generated javadocs, will be copied to a release specific directory for each release.
> ./index.html
> ./releases.html (Combined downloads + documentation for each release)
> ./contribute/BYLAWS.md
> ./contribute/Contributing-to-Storm.md
> ./contribute/People.md (Perhaps just PMC for this)
> ./_posts
> ./news.html
> ./feed.xml
> ./getting-help.html
> ./LICENSE.html (Apache License)
> ./talksAndVideos.md
> Possibly also:
> ./about/deployment.md
> ./about/fault-tolerant.md
> ./about/free-and-open-source.md
> ./about/guarantees-data-processing.md
> ./about/integrates.md
> ./about/multi-language.md
> ./about/scalable.md
> ./about/simple-api.md
> ./about.md
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)