mesos-reviews mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From haosdent huang <haosd...@gmail.com>
Subject Re: Review Request 52064: Support for multiple versions of docs.
Date Wed, 28 Sep 2016 03:56:07 GMT


> On Sept. 28, 2016, 3:20 a.m., haosdent huang wrote:
> > Get this error during build.
> > 
> > ```
> > git  version   2>&1:sh: git: command not found
> > /mesos/site/Rakefile:4:in `<top (required)>'
> > (See full trace by running task with --trace)
> > rake aborted!
> > git  version   2>&1:sh: git: command not found
> > /mesos/site/Rakefile:4:in `<top (required)>'
> > (See full trace by running task with --trace)
> > ```

Need to update the Dockerfile to fix this problem.

```
diff --git a/site/Dockerfile b/site/Dockerfile
index 8ba0be0..835e7df 100644
--- a/site/Dockerfile
+++ b/site/Dockerfile
@@ -3,7 +3,7 @@ MAINTAINER "dev@mesos.apache.org"

 LABEL Description="This image is used for generating Mesos web site from local sources and
serving it on port 4567 (livereload on port 35729)."

-RUN yum install -y gcc-c++ make ruby ruby-devel rake doxygen java-1.7.0-openjdk-devel
+RUN yum install -y gcc-c++ git make ruby ruby-devel rake doxygen java-1.7.0-openjdk-devel
 RUN gem install bundler

 ENV LANG en_US.UTF-8
```


- haosdent


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/52064/#review150673
-----------------------------------------------------------


On Sept. 19, 2016, 8:43 p.m., Tim Anderegg wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/52064/
> -----------------------------------------------------------
> 
> (Updated Sept. 19, 2016, 8:43 p.m.)
> 
> 
> Review request for mesos and Vinod Kone.
> 
> 
> Bugs: MESOS-3011
>     https://issues.apache.org/jira/browse/MESOS-3011
> 
> 
> Repository: mesos
> 
> 
> Description
> -------
> 
> Support for multiple versions of docs.  The approach I took was to use the "git" ruby
library to iterate over each tagged version of Mesos, and generate the documentation.  This
uses the "releases.yml" file to determine which versions should build documentation.  The
same is done for images, since they may change between versions.  A select box was added to
the website's breadcrumbs bar that allows the user to easily switch between documentation
versions.  If a page is reached that doesn't exist in an older version of the documentation,
the user is notified and redirect to the main page for that version.
> 
> 
> Diffs
> -----
> 
>   site/Gemfile 4dcd0a5ad452085e6e3bb152a6547575636cd807 
>   site/Gemfile.lock 1393246f06631155bb052669a86e431778e891bf 
>   site/Rakefile 01356891c29f9e69fa0f7813cf87e7662eda400b 
>   site/build.sh 11f15e15621c4d3db1472e88911787b9b3100f97 
>   site/config.rb 9e6738fccc48365e16221188269c1ed40772eca7 
>   site/data/releases.yml 1e9bb8555d266658baaf37c4b608eebeb0d14da8 
>   site/source/assets/js/versions.js PRE-CREATION 
>   site/source/layouts/basic.erb 7464e40b619e883daad93c72c3fbdbfbdda8f152 
>   site/source/layouts/documentation.erb a91f916a5fb7348b2702c272e7a2059bdf628c66 
>   site/source/layouts/gettingstarted.erb PRE-CREATION 
> 
> Diff: https://reviews.apache.org/r/52064/diff/
> 
> 
> Testing
> -------
> 
> Testing was done manually to verify that the documentation was built for each version
of Mesos that is supported (some older versions do not have compatible documentation).
> 
> 
> Thanks,
> 
> Tim Anderegg
> 
>


Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message