Yeah I think we can be incremental about this. - add the site to /site as is. This way even if it's a pain people can contribute - make a publish-site.sh - add some form of template system (probably to publish-site.sh) - finalize with documentation? < or add it as we go
On Thu, Aug 4, 2016 at 10:12 AM, Stephen Mallette <spmalle...@gmail.com> wrote: > There's not a lot of pages - true - though when i wear the release manager > hat i have grumble every time i have to go through all the links trying to > get it right. invariably i make a change, then copy/paste to the others > only to find i misspelled something or missed a link. it just sucks. That > said, i'm open to the idea of moving the site as-is to the git repo under a > /site directory. that would be the first step to doing the static site > generation anyway. > > if it doesn't hinge on static site generation, then perhaps it should hinge > on a little script or something that will bin/publish-site.sh - that would > be nice. > > On Thu, Aug 4, 2016 at 9:14 AM, Robert Dale <robd...@gmail.com> wrote: > > > Stephen, please correct me where I'm wrong, but after mirroring the > > site and removing docs and javadocs since these are generated, it > > would appear that there are only 7 html files to the website. It's not > > clear to me that at this point the effort of creating or moving to a > > template engine is worth the effort. I would rather see the static > > site as-is move to version control sooner rather than later and not > > hinge upon generation. > > > > On Wed, Aug 3, 2016 at 1:38 PM, Dylan Millikin <dylan.milli...@gmail.com > > > > wrote: > > > The groovy template engine could work just fine. > > > FYI : > > > > > http://stackoverflow.com/questions/3793880/lightweight- > template-engine-in-java > > > There might be a few interested template engines there as well. > > > > > > On Wed, Aug 3, 2016 at 9:40 AM, Stephen Mallette <spmalle...@gmail.com > > > > > wrote: > > > > > >> Yeah - i'm not so good with the sed to the awk to the grep or whatever > > so > > >> if it can be that simple that would be awesome. The groovy template > > engine > > >> might be another option. Something like that would work easy enough > too > > I > > >> would guess. I really don't think we need much more than that right > now. > > >> > > >> Organizationally, I think we should have a /site directory at the root > > of > > >> the repo to house the images/html template content and then have it > > >> generate into root /target/site from bin/generate-site.sh. > > >> > > >> On Wed, Aug 3, 2016 at 9:29 AM, Dylan Millikin < > > dylan.milli...@gmail.com> > > >> wrote: > > >> > > >> > Hmm sounds like what we would want would be a template engine that > > would > > >> > help us build the static site. > > >> > If all we need are includes that put together html partials > > >> > (headers/footers) we could make our own. It could be as simple as > > using > > >> sed > > >> > in bin/generate-web-site.sh > > >> > > > >> > On Wed, Aug 3, 2016 at 9:03 AM, Stephen Mallette < > > spmalle...@gmail.com> > > >> > wrote: > > >> > > > >> > > yes - static html/css and it sucks a bit because we don't have any > > >> re-use > > >> > > going on there. so if we have to change a menu or something it > means > > >> > > changing it on every page in the site. would be nice to have some > > >> > re-usable > > >> > > headers/footers and such. i looked into some static site > generators > > a > > >> > while > > >> > > back, but they all seemed like they did too much. maybe i didn't > > know > > >> > what > > >> > > to look for. > > >> > > > > >> > > On Wed, Aug 3, 2016 at 9:00 AM, Dylan Millikin < > > >> dylan.milli...@gmail.com > > >> > > > > >> > > wrote: > > >> > > > > >> > > > How is the current site structured? Is it just HTML and CSS > files? > > >> > > > > > >> > > > On Tue, Aug 2, 2016 at 6:20 PM, Stephen Mallette < > > >> spmalle...@gmail.com > > >> > > > > >> > > > wrote: > > >> > > > > > >> > > > > no - we don't have one for the main web site. i've wanted to > > >> suggest > > >> > > that > > >> > > > > we change that though and generate the main web site from the > > >> github > > >> > > > repo. > > >> > > > > in that way we could easily accept pull requests and such. i > > don't > > >> > > think > > >> > > > we > > >> > > > > want to take a full asciidoc approach and the web site > > generation > > >> > would > > >> > > > > probably stay separate from the doc generation, but it would > be > > >> nice > > >> > if > > >> > > > we > > >> > > > > could bin/generate-web-site.sh for a local build of that that > > thing > > >> > > which > > >> > > > > could then be published to the apache svn repo. anyone else > like > > >> that > > >> > > > idea? > > >> > > > > if so, how would it best be done? > > >> > > > > > > >> > > > > > > >> > > > > > > >> > > > > On Tue, Aug 2, 2016 at 5:05 PM, Robert Dale < > robd...@gmail.com> > > >> > wrote: > > >> > > > > > > >> > > > > > Is there a git repo for this and the main website? I would > > like > > >> to > > >> > > > > > make pull requests to fix some things. > > >> > > > > > > > >> > > > > > On Fri, Jul 29, 2016 at 1:49 PM, Stephen Mallette < > > >> > > > spmalle...@gmail.com> > > >> > > > > > wrote: > > >> > > > > > > The download page is now "live" > > >> > > > > > > > > >> > > > > > > On Thu, Jul 28, 2016 at 7:14 PM, Stephen Mallette < > > >> > > > > spmalle...@gmail.com> > > >> > > > > > > wrote: > > >> > > > > > > > > >> > > > > > >> I assume everyone is cool with making the Download Page > > live > > >> at > > >> > > this > > >> > > > > > point > > >> > > > > > >> as there's been no other feedback in the last few days. > > I'll > > >> > > > probably > > >> > > > > > make > > >> > > > > > >> some adjustments to the web site tomorrow to bring it > > online > > >> > > > publicly. > > >> > > > > > >> > > >> > > > > > >> On Mon, Jul 25, 2016 at 7:33 AM, Stephen Mallette < > > >> > > > > spmalle...@gmail.com > > >> > > > > > > > > >> > > > > > >> wrote: > > >> > > > > > >> > > >> > > > > > >>> I updated the downloads page some more: > > >> > > > > > >>> > > >> > > > > > >>> + tweaked the date format a bit to "really" match the > > rest of > > >> > the > > >> > > > > site > > >> > > > > > >>> (which is still inconsistent in other places like > > changelog - > > >> > > dah) > > >> > > > > > >>> + added a "verifying downloads" section which talks > about > > >> > > > > GPG/PGP/etc. > > >> > > > > > >>> > > >> > > > > > >>> http://tinkerpop.apache.org/downloads.html > > >> > > > > > >>> > > >> > > > > > >>> > > >> > > > > > >>> > > >> > > > > > >>> > > >> > > > > > >>> On Fri, Jul 22, 2016 at 3:53 PM, Stephen Mallette < > > >> > > > > > spmalle...@gmail.com> > > >> > > > > > >>> wrote: > > >> > > > > > >>> > > >> > > > > > >>>> Good feedback Robert/Jason. > > >> > > > > > >>>> > > >> > > > > > >>>> Updated: > > >> > > > > > >>>> > > >> > > > > > >>>> http://tinkerpop.apache.org/downloads.html > > >> > > > > > >>>> > > >> > > > > > >>>> Added documentation and included some descriptors to > > current > > >> > > > > releases. > > >> > > > > > >>>> Didn't change the date format for now - that's the > > format we > > >> > use > > >> > > > > > everywhere > > >> > > > > > >>>> around "release" so didn't want to muck with that at > this > > >> > point. > > >> > > > > > >>>> > > >> > > > > > >>>> > > >> > > > > > >>>> > > >> > > > > > >>>> On Fri, Jul 22, 2016 at 3:36 PM, Robert Dale < > > >> > robd...@gmail.com > > >> > > > > > >> > > > > > wrote: > > >> > > > > > >>>> > > >> > > > > > >>>>> Stephen, I think what Sebb might be getting at is that > > some > > >> > > > things > > >> > > > > > >>>>> should be spelled out even if they are obvious to > some. > > I > > >> > agree > > >> > > > > with > > >> > > > > > >>>>> this. > > >> > > > > > >>>>> > > >> > > > > > >>>>> 3.2.1 (latest, stable) > > >> > > > > > >>>>> 3.1.3 (bug fixes only) > > >> > > > > > >>>>> > > >> > > > > > >>>>> I think the dates should be in ISO8601 format. > > YYYY-MM-DD > > >> > > > > > >>>>> > > >> > > > > > >>>>> Otherwise, I think it looks very good. > > >> > > > > > >>>>> > > >> > > > > > >>>>> -- > > >> > > > > > >>>>> Robert Dale > > >> > > > > > >>>>> > > >> > > > > > >>>>> On Fri, Jul 22, 2016 at 2:51 PM, Jason Plurad < > > >> > > plur...@gmail.com > > >> > > > > > > >> > > > > > >>>>> wrote: > > >> > > > > > >>>>> > +1 looks great. > > >> > > > > > >>>>> > > > >> > > > > > >>>>> > Link to the documentation, maybe next to the release > > >> notes > > >> > > > link, > > >> > > > > > >>>>> would be > > >> > > > > > >>>>> > useful too. > > >> > > > > > >>>>> > > > >> > > > > > >>>>> > -- Jason > > >> > > > > > >>>>> > > > >> > > > > > >>>>> > On Fri, Jul 22, 2016 at 2:07 PM, Stephen Mallette < > > >> > > > > > >>>>> spmalle...@gmail.com> > > >> > > > > > >>>>> > wrote: > > >> > > > > > >>>>> > > > >> > > > > > >>>>> >> I think it might be a good idea to include a > > "Download > > >> > Page" > > >> > > > on > > >> > > > > > our > > >> > > > > > >>>>> web > > >> > > > > > >>>>> >> site. It would let us better list the versions we > > have > > >> out > > >> > > > there > > >> > > > > > and > > >> > > > > > >>>>> would > > >> > > > > > >>>>> >> get us better in line with Apache Infrastructure - > > for > > >> > > > example: > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> https://issues.apache.org/ > jira/browse/TINKERPOP-1255 > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> I'm also seeing that we yet have spots where we > dont' > > >> link > > >> > > to > > >> > > > > the > > >> > > > > > >>>>> mirror > > >> > > > > > >>>>> >> system. And finally, it would be nice to have a > > >> "generic" > > >> > > > > download > > >> > > > > > >>>>> page > > >> > > > > > >>>>> >> where we could point external links to - like the > new > > >> > > > > > "documentation" > > >> > > > > > >>>>> >> feature in StackOverflow (right now it's sorta > > hardcoded > > >> > to > > >> > > > the > > >> > > > > > >>>>> mirror > > >> > > > > > >>>>> >> which isn't so good because we'll have to change > that > > >> all > > >> > > the > > >> > > > > > time). > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> I quickly took a swipe at such a page: > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> http://tinkerpop.apache.org/downloads.html > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> It is NOT "linked to" by anything at this point so > > it is > > >> > > > > > "hidden". I > > >> > > > > > >>>>> just > > >> > > > > > >>>>> >> wanted to have something that everyone could look > at > > to > > >> > get > > >> > > > the > > >> > > > > > idea > > >> > > > > > >>>>> of > > >> > > > > > >>>>> >> what such a page might look like. > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> Thoughts? > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> Thanks, > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> >> Stephen > > >> > > > > > >>>>> >> > > >> > > > > > >>>>> > > >> > > > > > >>>> > > >> > > > > > >>>> > > >> > > > > > >>> > > >> > > > > > >> > > >> > > > > > > > >> > > > > > > > >> > > > > > > > >> > > > > > -- > > >> > > > > > Robert Dale > > >> > > > > > > > >> > > > > > > >> > > > > > >> > > > > >> > > > >> > > > > > > > > -- > > Robert Dale > > >