You are viewing a plain text version of this content. The canonical link for it is here.

Posted to dev@zeppelin.apache.org by IT CTO <go...@gmail.com> on 2015/10/22 16:50:01 UTC

Problem with documentation site

Hi
I just checked the issue reported in zeppelin-354 about the sample not
available on the doc site and I found out that although the code has the
reference and work locally, something in the deployment to ASF broke the
link and the official doc site is broken

http://zeppelin.incubator.apache.org/docs/rest-api/rest-json/rest-json-notebook-create.json
Not Found

The requested URL /docs/rest-api/rest-json/rest-json-notebook-create.json
was not found on this server.
I don;t know how the doc site works but we need to see how we can fix this.
Eran
-- 
Eran | "You don't need eyes to see, you need vision" (Faithless)

Re: Problem with documentation site

Posted by moon soo Lee <mo...@apache.org>.

Thanks for reporting the problem.

Zeppelin homepage is served from
https://svn.apache.org/repos/asf/incubator/zeppelin/site but github push is
not automatically synchronized to this svn repo. So far it has been
synchronized by manual job, i think the file has not been commit by mistake.
Just commit a missing file into svn repo.

Thanks,
moon


On Sat, Oct 24, 2015 at 10:12 PM Felix Cheung <fe...@hotmail.com>
wrote:

> I think loose files need to be put under docs/assets
> Doc is built using Jekyll
> https://help.github.com/articles/using-jekyll-with-pages/#installing-jekyll
> which processes the *.md files
>
> > From: goi.cto@gmail.com
> > Date: Thu, 22 Oct 2015 14:50:01 +0000
> > Subject: Problem with documentation site
> > To: dev@zeppelin.incubator.apache.org
>
> >
> > Hi
> > I just checked the issue reported in zeppelin-354 about the sample not
> > available on the doc site and I found out that although the code has the
> > reference and work locally, something in the deployment to ASF broke the
> > link and the official doc site is broken
> >
> >
> http://zeppelin.incubator.apache.org/docs/rest-api/rest-json/rest-json-notebook-create.json
> > Not Found
> >
> > The requested URL /docs/rest-api/rest-json/rest-json-notebook-create.json
> > was not found on this server.
> > I don;t know how the doc site works but we need to see how we can fix
> this.
> > Eran
> > --
> > Eran | "You don't need eyes to see, you need vision" (Faithless)
>

RE: Problem with documentation site

Posted by Felix Cheung <fe...@hotmail.com>.

I think loose files need to be put under  docs/assets  
Doc is built using Jekyll https://help.github.com/articles/using-jekyll-with-pages/#installing-jekyll
which processes the *.md files
 
> From: goi.cto@gmail.com
> Date: Thu, 22 Oct 2015 14:50:01 +0000
> Subject: Problem with documentation site
> To: dev@zeppelin.incubator.apache.org
> 
> Hi
> I just checked the issue reported in zeppelin-354 about the sample not
> available on the doc site and I found out that although the code has the
> reference and work locally, something in the deployment to ASF broke the
> link and the official doc site is broken
> 
> http://zeppelin.incubator.apache.org/docs/rest-api/rest-json/rest-json-notebook-create.json
> Not Found
> 
> The requested URL /docs/rest-api/rest-json/rest-json-notebook-create.json
> was not found on this server.
> I don;t know how the doc site works but we need to see how we can fix this.
> Eran
> -- 
> Eran | "You don't need eyes to see, you need vision" (Faithless)