Re: Documentation to the official online site svn?

[Woonsan Ko]

Wow, this is great!!!
Thank you very much.

As a side note, I'll try to follow the documentation to implement
something simple -- by using S2Graph of course -- such as "Related
articles" or "Related products" which are really popular use cases in
most websites nowadays, but it's hard to implement actually in an
automated way based on users' behaviors.
If we have simple 'running' examples somewhere for normal web
developers, I think it would help people adopt this project and
solutions.

Cheers,

Woonsan

On Thu, Mar 28, 2019 at 8:02 AM DO YUNG YOON  wrote:
>
> Hi Woonsan, Sorry for being late.
>
> I followed the instructions and the changes are now pushed to svn.
>
> Here is the updates
>
> - svn: https://svn.apache.org/repos/asf/incubator/s2graph/site (revision
> 1856470)
> - doc link on incubator site: *https://s2graph.apache.org/docs/index.html
> *
>
> Please check the updates and feel free to comment
>
>
> On Tue, Mar 5, 2019 at 11:10 PM Woonsan Ko  wrote:
>
> > Thanks a lot, Do Yung, as always!
> > Please tell me if there's anything I can help with.
> >
> > Cheers,
> >
> > Woonsan
> >
> > On Tue, Mar 5, 2019 at 12:12 AM DO YUNG YOON  wrote:
> > >
> > > Hi Woonsan.
> > >
> > > I agree with your suggestion, and I am volunteering for this.
> > > Let me try working on this on weekends then I will share any
> > > questions/updates.
> > >
> > > Thanks for your suggestion.
> > >
> > >
> > > On Tue, Mar 5, 2019 at 11:27 AM Woonsan Ko  wrote:
> > >
> > > > Hi folks,
> > > >
> > > > At the moment, the "Docs" link at the top menu bar [1] is linked to a
> > > > non-ASF URL [2].
> > > > I don't think we can keep the non-ASF pages there in the future.
> > > > Furthermore, the documentation there is outdated from the
> > > > documentation source at doc/.
> > > >
> > > > Our official documentation repository is the SVN [3], as of [4].
> > > >
> > > > Therefore, I'd like to propose the following:
> > > > 1. Initially one of the committers should generate the site html from
> > > > the doc/ in git source repo, following the instruction in
> > > > doc/readme.md, until `make html`, which generates all the html and
> > > > other static resource files at docs/build/html/. (I've just tested and
> > > > it works fine.)
> > > >And, the generated files at docs/build/html/** should be committed
> > > > to a new directory, "docs", in [3].
> > > > 2. Change the "Docs" menu link to "docs/index.html" from the external
> > link.
> > > > 3. From now on, whenever committers update documentation, once in a
> > > > while, do the step 1 and 2 periodically, to synchronize the online
> > > > site with the documentation source.
> > > >
> > > > When we really want to expand the community during the incubation
> > > > period, the online documentation is really crucial: new comers start
> > > > from there...
> > > >
> > > > Any thoughts?
> > > > If this sounds okay, any volunteers?
> > > >
> > > > Regards,
> > > >
> > > > Woonsan
> > > >
> > > > [1] http://s2graph.incubator.apache.org/
> > > > [2] https://steamshon.gitbooks.io/s2graph-book/content/
> > > > [3] http://svn.apache.org/repos/asf/incubator/s2graph/site/
> > > > [4] https://issues.apache.org/jira/browse/INFRA-11806
> > > >
> >

Re: Documentation to the official online site svn?

[DO YUNG YOON]

Hi Woonsan, Sorry for being late.

I followed the instructions and the changes are now pushed to svn.

Here is the updates

- svn: https://svn.apache.org/repos/asf/incubator/s2graph/site (revision
1856470)
- doc link on incubator site: *https://s2graph.apache.org/docs/index.html
*

Please check the updates and feel free to comment


On Tue, Mar 5, 2019 at 11:10 PM Woonsan Ko  wrote:

> Thanks a lot, Do Yung, as always!
> Please tell me if there's anything I can help with.
>
> Cheers,
>
> Woonsan
>
> On Tue, Mar 5, 2019 at 12:12 AM DO YUNG YOON  wrote:
> >
> > Hi Woonsan.
> >
> > I agree with your suggestion, and I am volunteering for this.
> > Let me try working on this on weekends then I will share any
> > questions/updates.
> >
> > Thanks for your suggestion.
> >
> >
> > On Tue, Mar 5, 2019 at 11:27 AM Woonsan Ko  wrote:
> >
> > > Hi folks,
> > >
> > > At the moment, the "Docs" link at the top menu bar [1] is linked to a
> > > non-ASF URL [2].
> > > I don't think we can keep the non-ASF pages there in the future.
> > > Furthermore, the documentation there is outdated from the
> > > documentation source at doc/.
> > >
> > > Our official documentation repository is the SVN [3], as of [4].
> > >
> > > Therefore, I'd like to propose the following:
> > > 1. Initially one of the committers should generate the site html from
> > > the doc/ in git source repo, following the instruction in
> > > doc/readme.md, until `make html`, which generates all the html and
> > > other static resource files at docs/build/html/. (I've just tested and
> > > it works fine.)
> > >And, the generated files at docs/build/html/** should be committed
> > > to a new directory, "docs", in [3].
> > > 2. Change the "Docs" menu link to "docs/index.html" from the external
> link.
> > > 3. From now on, whenever committers update documentation, once in a
> > > while, do the step 1 and 2 periodically, to synchronize the online
> > > site with the documentation source.
> > >
> > > When we really want to expand the community during the incubation
> > > period, the online documentation is really crucial: new comers start
> > > from there...
> > >
> > > Any thoughts?
> > > If this sounds okay, any volunteers?
> > >
> > > Regards,
> > >
> > > Woonsan
> > >
> > > [1] http://s2graph.incubator.apache.org/
> > > [2] https://steamshon.gitbooks.io/s2graph-book/content/
> > > [3] http://svn.apache.org/repos/asf/incubator/s2graph/site/
> > > [4] https://issues.apache.org/jira/browse/INFRA-11806
> > >
>