Awesome. The website looks good. Sijie, it would be good if you can add a documentation on how to build the website and the documentation.
- KN On Tue, Sep 13, 2016 at 5:29 PM, Sijie Guo <si...@apache.org> wrote: > We shipped the website and it is live under > http://distributedlog.incubator.apache.org/ > > The documentation has been re-organized into three major parts, one is > 'start' - including the pages to start, one is 'user-guide' - include pages > that users need to understand the architecture and use it, the remaining > one is 'admin-guide' - including the pages on how to operate the cluster > and such. > > The documentation is still not good enough. Please help us improve the > website if you find any issues. Also I created two master tickets to > tracking any improvements related to user-guide > <https://issues.apache.org/jira/browse/DL-53> and admin-guide > <https://issues.apache.org/jira/browse/DL-54>. > > - Sijie > > > On Fri, Sep 9, 2016 at 12:41 AM, Sijie Guo <si...@apache.org> wrote: > > > I played with jekyll-rst plugin to build the documentation and pushed the > > latest built website to my github : > > > > https://sijie.github.io/incubator-distributedlog/ > > > > The website contains two parts: > > > > - one is the content under directory website. it contains the information > > that probably will not be changed between releases, like community and > > developer information. > > - one is the content under directory docs. it contains all the > > documentation that is aligned with each release. > > > > The build.sh script under website will link the current docs as `latest` > > (we can add stable release once we come to a release) and build the whole > > site. > > > > Let me know if the structure looks good. If it is okay, we can push the > > website and iterate from there. > > > > - Sijie > > > > > > > > On Mon, Sep 5, 2016 at 6:02 PM, Sijie Guo <si...@apache.org> wrote: > > > >> I pushed old content to asf-site branch to current repo and enabled > >> gitpubsub. So the content of distributedlog.io is alive at > >> distributedlog.incubator.apache.org now. > >> > >> The new site will come up soon. > >> > >> Sijie > >> > >> > >> On Thursday, August 25, 2016, Sijie Guo <si...@apache.org> wrote: > >> > >>> Based on the post https://blogs.apache.org/infra > >>> /entry/git_based_websites_available, we can enable 'gitpubsub' on an > >>> asf git repo, so it will pull the content either under root directory > or > >>> `content` directory from *asf-site* branch of that repo. > >>> > >>> I checked other asf projects. I found there are two approaches to do > >>> that. > >>> > >>> 1) use a separated repo for storing the content of website. so they > will > >>> be two repo, one is `project` while the other one is typically > >>> `project`-site or `project`-web. > >>> 2) use a single repo and just put the built static content into the > *asf-site > >>> *branch. > >>> > >>> I am kind of leaning toward 2). since I'd like to put documentation and > >>> code together in a single repo. so it is good to make sure whenever > there > >>> is code change, the documentation should be updated and reflected. we > can > >>> probably write a script to build the website and push the built static > >>> content to *asf-site *branch. > >>> > >>> Any thoughts? > >>> > >>> - Sijie > >>> > >>> > >>> > >>> On Tue, Aug 23, 2016 at 10:00 PM, Sijie Guo <si...@apache.org> wrote: > >>> > >>>> Hi all, > >>>> > >>>> I put up a website following other apache project to use jekyll and > >>>> bootstrap. > >>>> > >>>> the demo is here https://sijie.github.io/incubator-distributedlog/ > >>>> and the git pull request: https://github.com/ap > >>>> ache/incubator-distributedlog/pull/13 > >>>> > >>>> most of the links are pointed to http://distributedlog.io/ directly > >>>> for now. we can try to use the jekyll-rst plugin > >>>> <https://github.com/xdissent/jekyll-rst> to compile existing rst > files > >>>> under doc to static files. > >>>> > >>>> Please take a look and let me know if it is okay. > >>>> > >>>> Also, I need to investigate how Apache can host the website from a git > >>>> repo. If anyone knows how to do it, please let me know. > >>>> > >>>> - Sijie > >>>> > >>>> > >>> > > >
